diff --git a/docs/README.md b/docs/README.md index 3690e8477..b0dbe7ff7 100644 --- a/docs/README.md +++ b/docs/README.md @@ -32,6 +32,13 @@ 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). +### Building the Japanese documentation + +- From the "docs" location run: + +`sphinx-build -a -b html -D language=ja . _build/html/ja` + + ## Building PDF documentation diff --git a/docs/about-feature-matrix.rst b/docs/about-feature-matrix.rst index 1279b5da9..e7454f3a6 100644 --- a/docs/about-feature-matrix.rst +++ b/docs/about-feature-matrix.rst @@ -136,17 +136,20 @@ + - + + - + + - - - + + + - - - - - + + + + + - - + + - + - - + + - + @@ -209,7 +212,7 @@ - + @@ -217,7 +220,7 @@ - + @@ -225,15 +228,15 @@ - + - + - + @@ -241,7 +244,7 @@ - + @@ -249,7 +252,7 @@ - + @@ -257,23 +260,23 @@ - - - - - + + + + + - - + + - + @@ -281,7 +284,7 @@ - + @@ -289,15 +292,15 @@ - + - + - + @@ -305,23 +308,23 @@ - - + + - + - - + + - + - + @@ -329,7 +332,7 @@ - + @@ -339,4 +342,131 @@
FeatureFeature PyMuPDF pikepdf PyPDF2 pdfrw
Supports Multiple Document FormatsSupports Multiple Document Formats PDF XPS @@ -155,7 +158,7 @@ FB2 CBZ SVG - Image + Image PDF @@ -169,39 +172,39 @@
ImplementationC and PythonC++ and PythonImplementationC and PythonC++ and Python Python Python
Render Document PagesAll document typesNo renderingNo renderingNo renderingRender Document PagesAll document typesNo renderingNo renderingNo rendering
Extract TextAll document typesExtract TextAll document types PDF onlyPDF only
Extract Vector GraphicsAll document typesExtract Vector GraphicsAll document types
Draw Vector Graphics (PDF)Draw Vector Graphics (PDF)
Based on Existing, Mature LibraryBased on Existing, Mature Library MuPDF QPDF
Automatic Repair of Damaged PDFsAutomatic Repair of Damaged PDFs
Encrypted PDFsEncrypted PDFs LimitedLimited
Linerarized PDFsLinerarized PDFs
Incremental UpdatesIncremental Updates
Integrates with Jupyter and IPython NotebooksIntegrates with Jupyter and IPython Notebooks
Joining / Merging PDF with other Document TypesAll document typesPDF only PDF only PDF only Joining / Merging PDF with other Document TypesAll document typesPDF only PDF only PDF only
OCR API for Seamless Integration with TesseractAll document typesOCR API for Seamless Integration with TesseractAll document types
Integrated Checkpoint / Restart Feature (PDF)Integrated Checkpoint / Restart Feature (PDF)
PDF Optional ContentPDF Optional Content
PDF Embedded FilesPDF Embedded Files LimitedLimited
PDF RedactionsPDF Redactions
PDF AnnotationsFullPDF AnnotationsFull LimitedLimited
PDF Form FieldsCreate, read, updatePDF Form FieldsCreate, read, update Limited, no creationLimited, no creation
PDF Page LabelsPDF Page Labels
Support Font Sub-SettingSupport Font Sub-Setting
+ + +
diff --git a/docs/about-performance.rst b/docs/about-performance.rst index 3f8171d5c..e4e3251d7 100644 --- a/docs/about-performance.rst +++ b/docs/about-performance.rst @@ -166,9 +166,9 @@
-
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.

+
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:

+

The results for all 7,031 pages are:

@@ -183,7 +183,7 @@
400
300
200
-
100

⏱

seconds
+
100

⏱

seconds
@@ -210,19 +210,19 @@
-
fastest
+
fastest
←
←
-
slowest
+
slowest

-
Text Extraction

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

+
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:

+

The results for all 7,031 pages are:

@@ -235,7 +235,7 @@
400
300
200
-
100

⏱

seconds
+
100

⏱

seconds
@@ -261,10 +261,10 @@
-
fastest
+
fastest
←
←
-
slowest
+
slowest
@@ -273,9 +273,9 @@
-
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.

+
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:

+

The results for all 7,031 pages are:

@@ -290,7 +290,7 @@
800
600
400
-
200

⏱

seconds
+
200

⏱

seconds
@@ -314,9 +314,9 @@
-
fastest
+
fastest
←
-
slowest
+
@@ -324,5 +324,67 @@
+ + + + diff --git a/docs/about.rst b/docs/about.rst index 14fe690c1..906449fce 100644 --- a/docs/about.rst +++ b/docs/about.rst @@ -53,9 +53,20 @@ License and Copyright .. 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.` diff --git a/docs/conf.py b/docs/conf.py index 4a7f6d90a..7d98cf011 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -98,6 +98,15 @@ # 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 ---------------------------------------------- diff --git a/docs/footer.rst b/docs/footer.rst index ee36058e1..5d16d704e 100644 --- a/docs/footer.rst +++ b/docs/footer.rst @@ -25,7 +25,38 @@ }); -

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.

+

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.

+ + + + + + + .. note - this ensures that the Sphinx build system will pull in the image (as it is referenced in an RST file) to _images, we don't want to display it via rst markup due to limitations (hence width:0), however we do want it available for our raw HTML diff --git a/docs/header.rst b/docs/header.rst index 98c0062e1..7b8891f4a 100644 --- a/docs/header.rst +++ b/docs/header.rst @@ -1,3 +1,11 @@ +.. meta:: + :author: Artifex + :description lang=en: PyMuPDF is a high-performance Python library for data extraction, analysis, conversion & manipulation of PDF (and other) documents. + :description lang=ja: PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。 + :keywords lang=en: PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, PDF Splitting, PDF Creation, Pyodide, PyScript + :keywords lang=ja: PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript + + .. raw:: html @@ -35,7 +43,7 @@
- Find #pymupdf on Discord + Find #pymupdf on Discord Discord logo
diff --git a/docs/locales/ja/LC_MESSAGES/about-feature-matrix.mo b/docs/locales/ja/LC_MESSAGES/about-feature-matrix.mo new file mode 100644 index 000000000..48abd9ab2 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/about-feature-matrix.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/about-feature-matrix.po b/docs/locales/ja/LC_MESSAGES/about-feature-matrix.po new file mode 100644 index 000000000..d2adae1de --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/about-feature-matrix.po @@ -0,0 +1,21 @@ +# 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" + diff --git a/docs/locales/ja/LC_MESSAGES/about-performance.mo b/docs/locales/ja/LC_MESSAGES/about-performance.mo new file mode 100644 index 000000000..48abd9ab2 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/about-performance.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/about-performance.po b/docs/locales/ja/LC_MESSAGES/about-performance.po new file mode 100644 index 000000000..d2adae1de --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/about-performance.po @@ -0,0 +1,21 @@ +# 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" + diff --git a/docs/locales/ja/LC_MESSAGES/about.mo b/docs/locales/ja/LC_MESSAGES/about.mo new file mode 100644 index 000000000..428ab0a68 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/about.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/about.po b/docs/locales/ja/LC_MESSAGES/about.po new file mode 100644 index 000000000..694a39bad --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/about.po @@ -0,0 +1,105 @@ +# 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" + +#: ../../about.rst:10 888b5bf60bc6435e90715e12dc2bdb28 +msgid "Features Comparison" +msgstr "機能の比較" + +#: ../../about.rst:16 f075f60743ac4eacb93bbfffad517ecc +msgid "Feature matrix" +msgstr "機能比較表" + +#: ../../about.rst:18 ff238380567645238b1fbe2e64e623b0 +msgid "" +"The following table illustrates how :title:`PyMuPDF` compares with other " +"typical solutions." +msgstr "以下の表は、:title:`PyMuPDF` が他の典型的な解決策と比較した場合の違いを示しています。" + +#: ../../about.rst:27 f2abbb9014ca4c8f82af6cd85a11704f +msgid "Performance" +msgstr "パフォーマンス" + +#: ../../about.rst:31 157fa531655e41478d9852f7c5e61f06 +msgid "" +"To benchmark :title:`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ページ）` にテキストと画像が含まれている固定されたセットのテストスイートを使用して、:title:`PyMuPDF` のパフォーマンスをさまざまなタスクに対してベンチマークします。" + +#: ../../about.rst:34 6a96665d1db74c969980db1fd2ea12a4 +msgid "Here are current results, grouped by task:" +msgstr "以下は、タスクごとにグループ化された現在の結果です：" + +#: ../../about.rst:43 785c3e70fdca4aab9372cdd5273dc82e +msgid "" +"For more detail regarding the methodology for these performance timings " +"see: :ref:`Performance Comparison Methodology`." +msgstr "これらのパフォーマンスのタイミングに関する方法論の詳細については、:ref:`パフォーマンス比較方法論` を参照してください。" + +#: ../../about.rst:48 986945aa34944c01bc1ea61c44f2fc6c +msgid "License and Copyright" +msgstr "ライセンスと著作権" + +#: ../../about.rst:52 70fb5ce138354820aca1754304e0ce36 +msgid "" +":title:`PyMuPDF` and :title:`MuPDF` are now available under both, open-" +"source :title:`AGPL` and commercial license agreements. Please read the " +"full text of the :title:`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 :title:`AGPL`, please contact " +"`Artifex `_ for more information " +"regarding a commercial license." +msgstr "PyMuPDFとMuPDFは現在、オープンソースのAGPLと商用ライセンス契約の両方で提供されています。ライセンスのガイドラインに従うことを確認するため、配布資料（COPYINGファイル）と `ここ `_ にあるAGPLライセンス契約の全文をお読みください。AGPLの要件を満たせないと判断された場合は、商用ライセンスに関する詳細情報については、 `Artifex `_ にお問い合わせください。" + +#: ../../about.rst:59 f3b337656b7043aaaf9dca11699f7c2d +msgid "" +":title:`Artifex` is the exclusive commercial licensing agent for " +":title:`MuPDF`." +msgstr ":title:`Artifex` Artifexは、:title:`MuPDF` の独占的な商業ライセンスエージェントです。" + +#: ../../about.rst:61 1303d3e636b94a99b70c1087641984d5 +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 ff0d4a3e0de94752b26e51a8a37bf914 +msgid "" +"This documentation covers **PyMuPDF v1.23.0rc1** features as of " +"**2023-08-10 00:00:01**." +msgstr "" + +#: ../../version.rst:5 7c2446c0ab554e95b8c263ac5713d6a5 +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 "" + +#: ../../footer.rst:-1 29505b8af3da40eda1190aeaab46fcba +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/algebra.mo b/docs/locales/ja/LC_MESSAGES/algebra.mo new file mode 100644 index 000000000..3120c5893 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/algebra.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/algebra.po b/docs/locales/ja/LC_MESSAGES/algebra.po new file mode 100644 index 000000000..07591b24f --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/algebra.po @@ -0,0 +1,374 @@ +# 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" + +#: ../../algebra.rst:6 813ba009ec774833bbcd496340eda09b +msgid "Operator Algebra for Geometry Objects" +msgstr "幾何学オブジェクトのためのオペレーター代数" + +#: ../../algebra.rst:10 0d2af547035941d8853df5738249e928 +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 39906200c9684896adf7213485a13e02 +msgid "" +"They all are special cases of Python sequences, see :ref:`SequenceTypes` " +"for more background." +msgstr "これらはすべてPythonシーケンスの特殊なケースであり、詳細については、PyMuPDFでのPythonシーケンスを引数として使用するを参照してください。" + +#: ../../algebra.rst:14 9b9740cb8b8f49188bdb74a669d32575 +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 ba82659191d14ec48fba8014a0fa2e29 +msgid "This chapter is a synopsis of what is possible." +msgstr "この章では、可能な操作の要約を説明します。" + +#: ../../algebra.rst:19 62f3145601b541b984b384091a6ba5b2 +msgid "General Remarks" +msgstr "一般的な注意事項" + +#: ../../algebra.rst:20 c566c8f6fe0c462aaab3ee536eba9e83 +msgid "" +"Operators can be either **binary** (i.e. involving two objects) or " +"**unary**." +msgstr "演算子は2つのオブジェクトを含むバイナリ演算子または単項演算子になります。" + +#: ../../algebra.rst:22 3e82a4487c63474a91f4b42106cbfb31 +msgid "" +"The resulting type of **binary** operations is either a **new object of " +"the left operand's class** or a bool." +msgstr "バイナリ演算の結果の型は、左オペランドのクラスの新しいオブジェクトまたはbool型です。" + +#: ../../algebra.rst:24 69f0f86c148241f5a4168f42234e032d +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 f961d84c146f40f588ec3d543489ec61 +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 821873dd1c924adcbea7641b0cc34487 +msgid "" +"may always be a number which then performs the operation on every " +"component of the first one," +msgstr "第2のオペランドは常に数値であり、それにより最初のオペランドのすべての要素に対して操作を行います。" + +#: ../../algebra.rst:29 372851491015464eab536977f0dc0f4e +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 9e4f0de5a2d54c2eaf1607c8de696d2a +msgid "" +"Rectangles support additional binary operations: **intersection** " +"(operator *\"&\"*), **union** (operator *\"|\"*) and **containment** " +"checking." +msgstr "矩形は追加のバイナリ演算をサポートしています：交差（演算子“&”）、結合（演算子“|”）、および包含チェック。" + +#: ../../algebra.rst:33 8768d96321144c42932ebe70ea897367 +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`` のような式が有効です" + +#: ../../algebra.rst:37 bb3416126e3d4e64aa063dd75ac8bbb5 +msgid "Unary Operations" +msgstr "単項演算" + +#: ../../algebra.rst:40 ../../algebra.rst:56 3fddc081d23642a89962017517d471c5 +#: f03cb99c327c4b4e90df5f100cde8236 +msgid "Oper." +msgstr "演算" + +#: ../../algebra.rst:40 ../../algebra.rst:56 1cd6dbc24bee4292af783f00b10193f8 +#: 67b2c86ac824433a8a4f67606f5d1d3a +msgid "Result" +msgstr "結果" + +#: ../../algebra.rst:42 d7ecc6c8753e478aaeb18e9d80d9f124 +msgid "bool(OBJ)" +msgstr "" + +#: ../../algebra.rst:42 82ed95910dae4ab2880a31277670d201 +msgid "is false exactly if all components of OBJ are zero" +msgstr "OBJのすべての成分がゼロの場合にのみfalse" + +#: ../../algebra.rst:43 5d04d3f792a541258921c969e4fd4013 +msgid "abs(OBJ)" +msgstr "" + +#: ../../algebra.rst:43 be27190f35bd43ac9953266759678142 +msgid "the rectangle area -- equal to norm(OBJ) for the other types" +msgstr "他のタイプに対してnorm(OBJ)と等しい長方形の面積" + +#: ../../algebra.rst:44 79a7403d69504c62a9d2fe563ab0d3b5 +msgid "norm(OBJ)" +msgstr "" + +#: ../../algebra.rst:44 b5ec5a9e82b34ed2a234969e12b1c3ec +msgid "square root of the component squares (Euclidean norm)" +msgstr "成分の二乗の平方根（ユークリッドノルム）" + +#: ../../algebra.rst:45 68fe924f3e6a4129b4e876ab688a87b1 +msgid "+OBJ" +msgstr "" + +#: ../../algebra.rst:45 1cbbf43935cd4406bf5969060d147a74 +msgid "new copy of OBJ" +msgstr "OBJの新しいコピー" + +#: ../../algebra.rst:46 5eee675e01914d72b3a8aae745147df9 +msgid "-OBJ" +msgstr "" + +#: ../../algebra.rst:46 534d7082639e4877b47e4292b350ef4c +msgid "new copy of OBJ with negated components" +msgstr "成分が反転されたOBJの新しいコピー" + +#: ../../algebra.rst:47 bd2693aa6aa84f5c834bdcea7776366a +msgid "~m" +msgstr "" + +#: ../../algebra.rst:47 ba7102093c0b47cdab7c219996e314bc +msgid "inverse of matrix \"m\", or the null matrix if not invertible" +msgstr "行列 \"m\" の逆行列、または逆行列が存在しない場合は零行列" + +#: ../../algebra.rst:52 ccdc8e3d558144c2b9f54fb7b33debc5 +msgid "Binary Operations" +msgstr "二項演算" + +#: ../../algebra.rst:53 385c2d08bdf14335ae2a50528cf29f8d +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\" の各成分に対して単純に実行されます。もし第二オペランドが数値でない場合、次のように定義されます：" + +#: ../../algebra.rst:58 fc7ab3b4445b44f2a24094468b75f591 +msgid "a+b, a-b" +msgstr "" + +#: ../../algebra.rst:58 1dfd49bc780d4b05b1fd934bc35c52d1 +msgid "component-wise execution, \"b\" must be \"a-like\"." +msgstr "成分ごとの実行。\"b\" は \"a\" と同様の要素数である必要があります。" + +#: ../../algebra.rst:59 20bf755d8f7a4a52b4e963e3723d629b +msgid "a*m, a/m" +msgstr "" + +#: ../../algebra.rst:59 874894abe1404d07bef2a934733f59e0 +msgid "" +"\"a\" can be a point, rectangle or matrix, but \"m\" must be " +":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:64 d4655a899c0242859c8156400cca311f +msgid "a&b" +msgstr "" + +#: ../../algebra.rst:64 de275cd2e53a4ed1955340ef4c5fd538 +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:67 49ad439978e7430f9ee87346e8f2b690 +msgid "a|b" +msgstr "" + +#: ../../algebra.rst:67 96c91fe2ea9741f4a3160762032fa53a +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:70 3a45cae998a14a458026775418b6d400 +msgid "b in a" +msgstr "" + +#: ../../algebra.rst:70 61b17d468f9b41ab90bd551e59e1f5cb +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:73 b82a4b8b83f047ce998f43f5d1e4340a +msgid "a == b" +msgstr "" + +#: ../../algebra.rst:73 be5f151fd91b4cd28dc1f9b9d9ab1752 +msgid "*True* if *bool(a-b)* is *False* (\"b\" may be \"a-like\")." +msgstr "bool(a-b) が `False` であれば `True` を返します（\"b\"は\"a-like\"である可能性があります）。" + +#: ../../algebra.rst:77 b6fc6540669146ed97ed098e5bb15b80 +msgid "Please note an important difference to usual arithmetic:" +msgstr "以下は通常の算術との重要な違いに注意してください：" + +#: ../../algebra.rst:79 41f57bc8d08c4ec390c19dcd19704b1c +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 `fitz.Identity " +"/ m`. But if you formulate `fitz.Identity * ~m`, the result will be " +"`fitz.Matrix()` (the null matrix)." +msgstr "行列の乗算は可換ではありません。つまり、一般に2つの行列に対して `m*n != n*m` が成り立ちます。また、逆行列を持たないゼロでない行列も存在します。例えば、`m = Matrix(1, 0, 1, 0, 1, 0)` のような行列があります。これらの行列で除算しようとすると、演算子 *\"/\"* を使用して `fitz.Identity / m` のような式で `ZeroDivisionError` 例外が発生します。しかし、`fitz.Identity * ~m` のように記述すると、結果は `fitz.Matrix()` （零行列）となります。" + +#: ../../algebra.rst:81 ea4197f624cd47238dd31180607bc2f5 +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 `fitz.Identity / m`." +msgstr "認めるところがあるかもしれませんが、これは矛盾を示しており、私たちはこれを取り除くことを検討しています。当面の間は、例外を回避し、`~m` が零行列であるかどうかをチェックするか、`fitz.Identity / m` を使用して `ZeroDivisionError` の可能性を受け入れることができます。" + +#: ../../algebra.rst:85 c88496037d3a40d6a79ea60482edbb24 +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:86 ce43454509e2470189a1952ff6200561 +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:87 d6b539bd50e54b6ab1b4e5728ca9a095 +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:88 d08fc8a61bec442bafcbb7494c5cdfda +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:89 81239c6054704fecaa4465d63bcb887a +msgid "`r * m1 * m2 == (r * m1) * m2 != r * (m1 * m2)`" +msgstr "" + +#: ../../algebra.rst:92 42c22a869f504aa3b7fb942af819765e +msgid "Some Examples" +msgstr "いくつかの例" + +#: ../../algebra.rst:95 f48155d1acc74b988ab9ebbe51bb9851 +msgid "Manipulation with numbers" +msgstr "数値の操作" + +#: ../../algebra.rst:96 2b21b674b941431485d39fbfc14deb0e +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:104 1608ca09d98a487588bceef5cf093b4a +msgid "" +"The following will create the upper left quarter of a document page " +"rectangle::" +msgstr "以下は、ドキュメントページの四角形の左上の四分の一を作成します::" + +#: ../../algebra.rst:112 82cb73867831475a87df289bcc6ee0fe +msgid "" +"The following will deliver the **middle point of a line** that connects " +"two points **p1** and **p2**::" +msgstr "以下は、点 `p1` と点 `p2` を結ぶ直線の中点を求めます::" + +#: ../../algebra.rst:122 877be437fc494609a539d6d5d2a17dc6 +msgid "Manipulation with \"like\" Objects" +msgstr "「Like」オブジェクトを用いた操作" + +#: ../../algebra.rst:124 5ceaf82fce7844cf8536efb47544998f +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:135 53459cb98aca452e89039358d19c28fd +msgid "To shift a rectangle for 5 pixels to the right, do this::" +msgstr "長方形を右に5ピクセルシフトさせるには、次のようにします::" + +#: ../../algebra.rst:141 b3bfe998139b49b8a484310679ca7c74 +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:181 a273f40f058d44a0a2f6401d9afa64f5 +msgid "As a specialty, rectangles support additional binary operations:" +msgstr "特に、長方形は追加の2項演算をサポートしています：" + +#: ../../algebra.rst:183 ae804030722e4ec7974304bc85ac2947 +msgid "**intersection** -- the common area of rectangle-likes, operator *\"&\"*" +msgstr "**交差** -- 長方形や類似の長方形の共通領域を示す演算子 *\"&\"*" + +#: ../../algebra.rst:184 3391d52a100140259a984fa3683fecb0 +msgid "" +"**inclusion** -- enlarge to include a point-like or rect-like, operator " +"*\"|\"*" +msgstr "**含有** -- 点状または長方形状を含むように拡大する演算子 *\"|\"*" + +#: ../../algebra.rst:185 455ab97641f54c089ef32ef57d12ebbd +msgid "**containment** check -- whether a point-like or rect-like is inside" +msgstr "**含有確認** 点状または長方形状が内部にあるかどうかを確認します" + +#: ../../algebra.rst:187 06c181c1fc0848aeb8c4ad5a38900596 +msgid "" +"Here is an example for creating the smallest rectangle enclosing given " +"points::" +msgstr "以下は、与えられた点を囲む最小の長方形を作成する例です::" + +#: ../../footer.rst:-1 9ee55d59589e4caf9cf2c1a9039b8467 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/annot.mo b/docs/locales/ja/LC_MESSAGES/annot.mo new file mode 100644 index 000000000..25a177b98 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/annot.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/annot.po b/docs/locales/ja/LC_MESSAGES/annot.po new file mode 100644 index 000000000..d86717e4e --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/annot.po @@ -0,0 +1,1454 @@ +# 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" + +#: ../../annot.rst:7 3b44369b87274b07865b9796c069f286 +msgid "Annot" +msgstr "Annot (注釈)" + +#: ../../annot.rst:8 bc683ca9b67d4517ad2d367ac83ea67f +msgid "**This class is supported for PDF documents only.**" +msgstr "**このクラスはPDFドキュメントのみに対応しています。** " + +#: ../../annot.rst:10 3037c34304544c4ab2620db66a1d003a +msgid "" +"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.\"" +msgstr ":ref:`AdobeManual` からの引用: 「注釈は、ノート、音声、動画などのオブジェクトをPDFドキュメントのページ上の位置に関連付けるか、マウスとキーボードを介してユーザーと対話する手段を提供します。」" + +#: ../../annot.rst:12 a651563370954a53bdf63eb9983b36d6 +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:15 a7e9f9b2c24e4f29852c1afb58486fa2 +msgid "**Attribute**" +msgstr " **属性** " + +#: ../../annot.rst:15 5ae3e348086d4bf0837f4d3547c7b3e3 +msgid "**Short Description**" +msgstr " **短い説明** " + +#: ../../annot.rst:17 a07fbe87bfd743b789b09176cc131f94 +msgid ":meth:`Annot.delete_responses`" +msgstr "" + +#: ../../annot.rst:17 b3eacfe925b44e0a8c378aa1c3125483 +msgid "delete all responding annotions" +msgstr "すべての応答アノテーションを削除します" + +#: ../../annot.rst:18 c0f62895f80646f49eca57f123c705a9 +msgid ":meth:`Annot.get_file`" +msgstr "" + +#: ../../annot.rst:18 755e4a9f66f64b9e9b18cae6af06d09c +msgid "get attached file content" +msgstr "添付ファイルの内容を取得します" + +#: ../../annot.rst:19 661bdbceea2d4dc087fdde391328465c +msgid ":meth:`Annot.get_oc`" +msgstr "" + +#: ../../annot.rst:19 57519e02c3cf4205aeefc5bcc5bbc7d6 +msgid "get :data:`xref` of an :data:`OCG` / :data:`OCMD`" +msgstr ":data:`xref` を :data:`OCG` または :data:`OCMD` に取得します。" + +#: ../../annot.rst:20 27a8686eeaa04874bbe702c190c222eb +msgid ":meth:`Annot.get_pixmap`" +msgstr "" + +#: ../../annot.rst:20 2ed44f73094840d0a3b6e7ed0e712289 +msgid "image of the annotation as a pixmap" +msgstr "アノテーションの画像をピクマップとして取得します" + +#: ../../annot.rst:21 ab252abd78874e5096f3d7de9dcbc015 +msgid ":meth:`Annot.get_sound`" +msgstr "" + +#: ../../annot.rst:21 c90bc86fc7994e338dcec039d085293f +msgid "get the sound of an audio annotation" +msgstr "オーディオアノテーションの音声を取得します" + +#: ../../annot.rst:22 4110b32acce742a59eccffb4970db3bd +msgid ":meth:`Annot.get_text`" +msgstr "" + +#: ../../annot.rst:22 ../../annot.rst:23 146d35a366c44a9ab4e8e342a636fd54 +#: 5a19d6ba89594901bc9f1a8a51f65991 +msgid "extract annotation text" +msgstr "アノテーションテキストを抽出します" + +#: ../../annot.rst:23 014846c0411d434e8881507f3fabd499 +msgid ":meth:`Annot.get_textbox`" +msgstr "" + +#: ../../annot.rst:24 ce9e86c8e1f74765a444b7dab1bb135a +msgid ":meth:`Annot.set_border`" +msgstr "" + +#: ../../annot.rst:24 e30e3712b18d4f4b8b567c020a1dc1e3 +msgid "set annotation's border properties" +msgstr "アノテーションの境界線のプロパティを設定します" + +#: ../../annot.rst:25 091d733ad89c409da9bb830447924662 +msgid ":meth:`Annot.set_blendmode`" +msgstr "" + +#: ../../annot.rst:25 e9c99adc440e4d0e96f13a7e97533910 +msgid "set annotation's blend mode" +msgstr "アノテーションのブレンドモードを設定します" + +#: ../../annot.rst:26 94c945d08359498989e68094af5f5292 +msgid ":meth:`Annot.set_colors`" +msgstr "" + +#: ../../annot.rst:26 45e61ebeee3046bba2b030d3ae88323f +msgid "set annotation's colors" +msgstr "アノテーションの色を設定します" + +#: ../../annot.rst:27 ../../annot.rst:320 1614af626c0342059e3bdd1a00d1778c +#: 4cfa94c8399c481bab48699252ed1495 +msgid ":meth:`Annot.set_flags`" +msgstr "" + +#: ../../annot.rst:27 f5defbec79c54a3189500b21c60e3500 +msgid "set annotation's flags field" +msgstr "アノテーションのフラグフィールドを設定します" + +#: ../../annot.rst:28 1c98a89d1767488bba48e40dc19d2623 +msgid ":meth:`Annot.set_irt_xref`" +msgstr "" + +#: ../../annot.rst:28 77d55791494848f3a6e992ce628cb1b3 +msgid "define the annotation to being \"In Response To\"" +msgstr "アノテーションを「応答対象」として定義します" + +#: ../../annot.rst:29 29ccb80eaeaa4959a529ea73baa659e7 +msgid ":meth:`Annot.set_name`" +msgstr "" + +#: ../../annot.rst:29 4b478490f44e4570b423b983a44987a8 +msgid "set annotation's name field" +msgstr "アノテーションの名前フィールドを設定します" + +#: ../../annot.rst:30 ../../annot.rst:321 b0b361604dea4739a7f66d7ce214c313 +#: e1a9b3d8376e4b59ae7ac57a72b54b9a +msgid ":meth:`Annot.set_oc`" +msgstr "" + +#: ../../annot.rst:30 fdb24926db0e4b4f8ae48e3f0b1e2c07 +msgid "set :data:`xref` to an :data:`OCG` / :data:`OCMD`" +msgstr ":data:`xref` を :data:`OCG` または :data:`OCMD` に設定します。" + + +#: ../../annot.rst:31 f6df0ea961a44439ae124ff19c6a84aa +msgid ":meth:`Annot.set_opacity`" +msgstr "" + +#: ../../annot.rst:31 3b80eeb9898349a0bf43291e515b3589 +msgid "change transparency" +msgstr "透明度を変更します" + +#: ../../annot.rst:32 d8e675acce8647d0a616f6bde39c2aa5 +msgid ":meth:`Annot.set_open`" +msgstr "" + +#: ../../annot.rst:32 e8f18b9101d64f479fef5b3b77932f0c +msgid "open / close annotation or its Popup" +msgstr "アノテーションまたはそのポップアップを開く/閉じる" + +#: ../../annot.rst:33 6df4665bc46b44cabea63b840624f324 +msgid ":meth:`Annot.set_popup`" +msgstr "" + +#: ../../annot.rst:33 c98a7f9820e7401788753fe8fa44f2b5 +msgid "create a Popup for the annotation" +msgstr "アノテーションのためのポップアップを作成します" + +#: ../../annot.rst:34 ../../annot.rst:319 54a69e131d83486e86c70eaa537eb471 +#: b494d77df89b40dea8fca39c7811fdcd +msgid ":meth:`Annot.set_rect`" +msgstr "" + +#: ../../annot.rst:34 52b054a70ded484981ba00b8a9ed49ef +msgid "change annotation rectangle" +msgstr "アノテーションの長方形を変更します" + +#: ../../annot.rst:35 027195dad8614e159d27a1c1521aa65c +msgid ":meth:`Annot.set_rotation`" +msgstr "" + +#: ../../annot.rst:35 c3aa0b6483e1433eaf02dca6245ab0f0 +msgid "change rotation" +msgstr "回転を変更します" + +#: ../../annot.rst:36 ../../annot.rst:322 b2ccd102411e44b49bff3ea5bf51024c +#: ee76c5a90c0a453f9b865b4d9328f227 +msgid ":meth:`Annot.update_file`" +msgstr "" + +#: ../../annot.rst:36 0f123691fab5474b8f4c3911537246b6 +msgid "update attached file content" +msgstr "添付ファイルの内容を更新します" + +#: ../../annot.rst:37 5f9b66c1247442caa55bd171bd29b8f3 +msgid ":meth:`Annot.update`" +msgstr "" + +#: ../../annot.rst:37 6ef04d7743484a0ca242208e7449a8ae +msgid "apply accumulated annot changes" +msgstr "蓄積されたアノテーションの変更を適用します" + +#: ../../annot.rst:38 fd4ef5f6fafa488990c6499d31cdedf1 +msgid ":attr:`Annot.blendmode`" +msgstr "" + +#: ../../annot.rst:38 8fa964bf13644714869898cfcb98a7e1 +msgid "annotation BlendMode" +msgstr "アノテーションのブレンドモード" + +#: ../../annot.rst:39 068458ba501b494ebd2b1898da54c610 +msgid ":attr:`Annot.border`" +msgstr "" + +#: ../../annot.rst:39 c13735090b6e4768bc066dfe0cbad901 +msgid "border details" +msgstr "境界線の詳細" + +#: ../../annot.rst:40 7c90bfc1d12a40ffbf5ac95bfc790814 +msgid ":attr:`Annot.colors`" +msgstr "" + +#: ../../annot.rst:40 6b10c999e28f407a8965a436e8efbfab +msgid "border / background and fill colors" +msgstr "境界線/背景および塗りつぶしの色" + +#: ../../annot.rst:41 153e59e7a86248578ccddebc92c5bc7e +msgid ":attr:`Annot.file_info`" +msgstr "" + +#: ../../annot.rst:41 2c69f672a6e749bea6ae448a497b20ad +msgid "get attached file information" +msgstr "添付ファイル情報を取得します" + +#: ../../annot.rst:42 222cae007cb24b99856a12db4182e28b +msgid ":attr:`Annot.flags`" +msgstr "" + +#: ../../annot.rst:42 7634442b962644a2b4cca2119592f49d +msgid "annotation flags" +msgstr "アノテーションフラグ" + +#: ../../annot.rst:43 3f9a959b33f84d49843ed47f14d853f5 +msgid ":attr:`Annot.has_popup`" +msgstr "" + +#: ../../annot.rst:43 4ea4fcca9c024664b304c329e3c1c745 +msgid "whether annotation has a Popup" +msgstr "アノテーションにポップアップがあるかどうか" + +#: ../../annot.rst:44 0a29ff4930544cc39da47776eff666ad +msgid ":attr:`Annot.irt_xref`" +msgstr "" + +#: ../../annot.rst:44 cd4482d320da4e79afb36df75af518a9 +msgid "annotation to which this one responds" +msgstr "このアノテーションへの応答としてのアノテーション" + +#: ../../annot.rst:45 54cc9fbd9f2c40898861dea193a23289 +msgid ":attr:`Annot.info`" +msgstr "" + +#: ../../annot.rst:45 4647006b6b8d40949246abe0e856f9cf +msgid "various information" +msgstr "さまざまな情報" + +#: ../../annot.rst:46 b9e02121d9df4286914bb81135a1cae6 +msgid ":attr:`Annot.is_open`" +msgstr "" + +#: ../../annot.rst:46 d0be5260eac649b09d0fc76d1e6cf923 +msgid "whether annotation or its Popup is open" +msgstr "アノテーションまたはそのポップアップが開いているかどうか" + +#: ../../annot.rst:47 96afdb62dd264857ae641d1e67cbd4f6 +msgid ":attr:`Annot.line_ends`" +msgstr "" + +#: ../../annot.rst:47 e5f0e9967cac4a398f8910554ad8b41d +msgid "start / end appearance of line-type annotations" +msgstr "線タイプのアノテーションの始点/終点の外観" + +#: ../../annot.rst:48 ece421ccb9564da0b01b3ed98199abaf +msgid ":attr:`Annot.next`" +msgstr "" + +#: ../../annot.rst:48 ae213998ff0340f88a358d724a15c55b +msgid "link to the next annotation" +msgstr "次のアノテーションへのリンク" + +#: ../../annot.rst:49 01201331d4874aa4a60b4299877d4bf6 +msgid ":attr:`Annot.opacity`" +msgstr "" + +#: ../../annot.rst:49 557df907868240dabe6e9be23e4cc67a +msgid "the annot's transparency" +msgstr "アノテーションの透明度" + +#: ../../annot.rst:50 2835d7933755413aacadcab255d51105 +msgid ":attr:`Annot.parent`" +msgstr "" + +#: ../../annot.rst:50 0887a309600c4ca698263126884ffdcb +msgid "page object of the annotation" +msgstr "アノテーションのページオブジェクト" + +#: ../../annot.rst:51 1171914f918b4d4b9ba068c1d83965aa +msgid ":attr:`Annot.popup_rect`" +msgstr "" + +#: ../../annot.rst:51 e2f1df56580d43e39427aad94e2fad7f +msgid "rectangle of the annotation's Popup" +msgstr "アノテーションのポップアップの長方形" + +#: ../../annot.rst:52 fb79c864570343648e3bd02e5405ab73 +msgid ":attr:`Annot.popup_xref`" +msgstr "" + +#: ../../annot.rst:52 760ff40bb0d84ecc97e5413af09871de +msgid "the PDF :data:`xref` number of the annotation's Popup" +msgstr "アノテーションのポップアップのPDF :data:`xref` 番号" + +#: ../../annot.rst:53 ecdb2bc6bb79400999b0645903fd30cd +msgid ":attr:`Annot.rect`" +msgstr "" + +#: ../../annot.rst:53 a320554faf2d49a48dcd7c004dea6b22 +msgid "rectangle containing the annotation" +msgstr "アノテーションを含む長方形" + +#: ../../annot.rst:54 3e3a45eb5f944fc9b87729b83781010e +msgid ":attr:`Annot.type`" +msgstr "" + +#: ../../annot.rst:54 d0a5864ce9394b3685e03f696e832506 +msgid "type of the annotation" +msgstr "アノテーションのタイプ" + +#: ../../annot.rst:55 c3a17f57621e445fa53e4e3611087cff +msgid ":attr:`Annot.vertices`" +msgstr "" + +#: ../../annot.rst:55 b819d44e2bf14251b72a918b66b86180 +msgid "point coordinates of Polygons, PolyLines, etc." +msgstr "ポリゴン、ポリラインなどの点の座標" + +#: ../../annot.rst:56 9d91e1751e694b33b06a5b19ae0f4bef +msgid ":attr:`Annot.xref`" +msgstr "" + +#: ../../annot.rst:56 fd58b5ba677d4a02a0160574ee8f9ec2 +msgid "the PDF :data:`xref` number" +msgstr "PDF :data:`xref` 番号" + +#: ../../annot.rst:59 1a6907b8ffdb498db17ff8c23b00f014 +msgid "**Class API**" +msgstr " **APIクラス** " + +#: ../../annot.rst:71 e85c3a1672514473bf6aa2b86e078063 +msgid "Changed in v1.19.2: added support of dpi parameter." +msgstr "v1.19.2で変更: dpiパラメータのサポートが追加されました。" + +#: ../../annot.rst:73 7c5f5d2d15a2414c906d90750e74cfaf +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 014cd49fd25148db9eb080d9aeb32f48 +#: 06503a24fede40ba94ffa25a891b5580 13c75ddea34640f880b15b25b6f38ac1 +#: 1d9c89970b3c48ce91204323b215b90a 2858846ed4284c36a2357373d2b4924f +#: 3f711a8c65404692bb38638068fa2a4e 44d17d1afbc8417ea4cb16008f13984e +#: 4c04f912cdb24d8a8c2e85a502803df8 50560649e45d41f4bb074f7fc2dbac04 +#: 61caeb8ddcc24f898b89646d45f3dbdc 63a9577c20b24997b2a22217f71bfdcd +#: 7e897d8d1d3246b5afcd21fe94898832 8d6427559ef148bab36c19a8b1791794 +#: c58e3af913a646439641fcc9dc581b1f cbafe6bb005349d4b2cc75799917eb87 +#: dea46837562040e3bca09c683934cd6a df723b0fa80d45eabdd1437bc3b9c59a +#: e7c08f7ae97d4b41a3facfd4b0933295 f05acfdd49224d3db26f5db521f21e10 +msgid "Parameters" +msgstr "パラメータ" + +#: ../../annot.rst:75 305c8175fea44b69b50ea0c4d11a6940 +msgid "a matrix to be used for image creation. Default is :ref:`Identity`." +msgstr "画像の作成に使用される行列。デフォルトは :ref:`Identity` です。" + +#: ../../annot.rst:77 1f7052d1c353453b8a3b8f88d809de12 +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:79 b08104e2be7d4c89938681fc82464acb +msgid "a colorspace to be used for image creation. Default is *fitz.csRGB*." +msgstr "画像の作成に使用されるカラースペース。デフォルトは *fitz.csRGB* です。" + +#: ../../annot.rst:82 1a92d0a6269e45058bc674dd3f0dd5e5 +msgid "whether to include transparency information. Default is *False*." +msgstr "透明情報を含めるかどうか。デフォルトは *False* です。" + +#: ../../annot.rst 02a36f51f73d4a7eb9a230ed09ffd671 +#: 0f36b0937b224d56ae0b798e9e25ddd7 11d8779361ed4fb98d85a63e9d9e90c6 +#: 1513c4bf46ca4cb7b76a94171b768175 16798ba59df14ec7b3e5469f82585b32 +#: 1bddc63e5af7455f9e53585a3f9de4bc 20176a0bd54c42a6a71ab9a76f9b0f22 +#: 28aa435c56ec435aa1b17c09d9c1e00c 30c47db631944ff6abc03e798dd8c404 +#: 30dc30bef584434f9ab87cbdc4e16633 33a32ec9cbd344e9915ad7620c671824 +#: 493b2f17683d4f8c9f80121c6cbd351b 4fda4661f3874e5aabb0950d6ced46ca +#: 887587d71f86445884e3b4dd8a2d31c6 8a3da1772fef4bc0ba04e28a0416f6ff +#: a5a0d69953b54a71930d1baa27e41225 aacd912ff3054e59826201d22f24488c +#: ac7f9d620fe2479f85c4063d396b07a2 c7cd8de163dd4effb782277a05f2347f +#: ca05ffd22c614a3e9a8d4feecc61383c cc5b65ca5d42466ead1f6c8c13f89836 +#: d1880fa810044014bd29ff9151679c9e d38dc4b0e8994799917863903efc78b4 +#: fab7f42712c74d5ca07b1d3f6b5e5a4e +msgid "Return type" +msgstr "戻り値の型" + +#: ../../annot.rst:84 fd1d09c4d4c5484e9397a998e3ea5da6 +msgid ":ref:`Pixmap`" +msgstr "" + +#: ../../annot.rst:86 c7a728beaf554acb8e90f1084167a0f1 +msgid "" +"If the annotation has just been created or modified, you should reload " +"the page first via *page = doc.reload_page(page)*." +msgstr "注釈が作成または変更されたばかりの場合、まず *page = doc.reload_page(page)* を使用してページを再読み込みする必要があります。" + +#: ../../annot.rst:104 ../../annot.rst:125 3f31549b13424f96b6c575435d5c507a +#: e8052a8a0e5f466ba2db9da717442148 +msgid "New in 1.18.0" +msgstr "1.18.0 で新たに追加" + +#: ../../annot.rst:106 d6512e2461ba4fa0afb2186992094bbc +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:108 2215ad6d0ec940fc8737322a7ea217e1 +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:108 7d17552724084f938284f36459e0284e +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:110 e8d0695856f444fcb7eb883d3427b081 +msgid "\"text\" -- :meth:`TextPage.extractTEXT`, default" +msgstr "\"text\" -- :meth:`TextPage.extractTEXT`、デフォルト" + +#: ../../annot.rst:111 fec71ebd95f540a0b29d1c4aad83f517 +msgid "\"blocks\" -- :meth:`TextPage.extractBLOCKS`" +msgstr "" + +#: ../../annot.rst:112 22f9c92b2858409692e0c767c5f61b21 +msgid "\"words\" -- :meth:`TextPage.extractWORDS`" +msgstr "" + +#: ../../annot.rst:113 4f61f534352444edbac98cc460c8c292 +msgid "\"html\" -- :meth:`TextPage.extractHTML`" +msgstr "" + +#: ../../annot.rst:114 257adb16f060414f9bec766cf2501cbd +msgid "\"xhtml\" -- :meth:`TextPage.extractXHTML`" +msgstr "" + +#: ../../annot.rst:115 b982e7577b6e488ea292d647ff664e29 +msgid "\"xml\" -- :meth:`TextPage.extractXML`" +msgstr "" + +#: ../../annot.rst:116 a077c4c5072744fb8ac881f23d9929ff +msgid "\"dict\" -- :meth:`TextPage.extractDICT`" +msgstr "" + +#: ../../annot.rst:117 91a05ef6e849453db171fad0770df9f9 +msgid "\"json\" -- :meth:`TextPage.extractJSON`" +msgstr "" + +#: ../../annot.rst:118 f9693a262bc943858c18e614fb9d0557 +msgid "\"rawdict\" -- :meth:`TextPage.extractRAWDICT`" +msgstr "" + +#: ../../annot.rst:120 4c7d403e62c44869b69c63d4401fca81 +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:121 e9d7f0d5127442b79b1b6a21be6caa13 +msgid "" +"(keyword only) control the amount of data returned. Defaults to simple " +"text extraction." +msgstr "(キーワードのみ) 返されるデータの量を制御します。単純なテキスト抽出がデフォルトです。" + +#: ../../annot.rst:127 30d3810f3e504cbfbbda5bd8cf036453 +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:129 a67fbfe7b40a4a30b4220a6461fae5b2 +msgid "the area to consider, defaults to :attr:`Annot.rect`." +msgstr "rect (rect-like) – 考慮する領域、デフォルトは :attr:`Annot.rect` です。" + +#: ../../annot.rst:134 c9248f70691b4467994b4e396e4d1d68 +msgid "Changed in version 1.16.10" +msgstr "バージョン 1.16.10 で変更" + +#: ../../annot.rst:136 6ee03ac3b87140fa915d061af58067d7 +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:138 780eb03f19e34d92895b8d006a85f70c +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:139 ../../annot.rst:140 ../../annot.rst:143 +#: 3475de14fdb54721b31ad025bcc04162 a3e55922bac2478db2e9b9c94a2378e4 +#: f6755961921b4342ab94e0b9af83fd5c +msgid "*(new in v1.16.10)* see description in :attr:`info`." +msgstr "*（v1.16.10 で新規追加）* :attr:`info` の説明を参照してください。" + +#: ../../annot.rst:141 8c005250c89c44f7a50116a2213a8a07 +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:142 9ae4e24d0b844f7f8c30af1432fddca8 +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:147 32484b1cf84e4d8f9734cc70b2cc0322 +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:151 f4dcd456a7f64ef78e0cb9e1fe5afc9e +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」の線終端をサポートしていません。なぜなら、そのコールアウトバリアントはサポートされていないからです。" + +#: ../../annot.rst:152 2fa286e7b4ef4a14a3ee911d26eb0cd9 +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* 引数を使用して、線終端シンボルに独自の塗りつぶし色を設定することができるようになりました。" + +#: ../../annot.rst:154 70f82a50972b4b8f85aee7ca2947109f +msgid "The symbol number for the first point." +msgstr "最初の点のシンボル番号。" + +#: ../../annot.rst:155 dc2fa1adad044939a2fe94f7f3acec31 +msgid "The symbol number for the last point." +msgstr "最後の点のシンボル番号。" + +#: ../../annot.rst:159 43d7e784c89e4ccda829ce450906b5ec +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:161 84583c6f6a2f4bb992a6126649b7d2b1 +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:163 a3c33eb3fc204cf0af1903305d923ab7 +msgid "This does **not require executing** :meth:`Annot.update` to take effect." +msgstr "これは :meth:`Annot.update` の **実行を必要としません。** " + +#: ../../annot.rst:167 242da23a4be04f8e801a07bfe67a1505 +msgid "" +"Return the :data:`xref` of an optional content object, or zero if there " +"is none." +msgstr "オプションコンテンツオブジェクトの :data:`xref` 、または存在しない場合はゼロを返します。" + +#: ../../annot.rst 51594138673b4772b412635b463070e2 +#: 5648b17d1298466980cee38ec1ddac99 9806b1daae7f4f808e7280d37707a84e +#: c83cb4306ce743d993ea294909661670 ccfa332676724a78a386497e9424edc5 +#: d580e1c4bbfa4cc586d81d7b3e6b3d9b +msgid "Returns" +msgstr "戻り値" + +#: ../../annot.rst:169 77902d1bb31d4249acaa96571bb88187 +msgid "zero or the xref of an OCG (or OCMD)." +msgstr "ゼロまたはOCG（またはOCMD）のxref。" + +#: ../../annot.rst:174 3b02578225b34f9988e20c4383ff4913 +msgid "New in v1.19.3" +msgstr "v1.19.3 で新規追加" + +#: ../../annot.rst:176 78e9745ee8d24ce1a4a2ecdd8e3bc312 +msgid "Set annotation to be \"In Response To\" another one." +msgstr "注釈を別の注釈への「応答として」設定します。" + +#: ../../annot.rst:178 48efb26106214d799b692be7dd1c1d30 +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:178 9a779927274245c8b26692c80e24961c +msgid "The :data:`xref` of another annotation." +msgstr "別の注釈の :data:`xref` 。" + +#: ../../annot.rst:180 1aba151a8f864bd4a74bc3f6976ceb45 +msgid "" +"Must refer to an existing annotation on this page. Setting this property " +"requires no subsequent `update()`." +msgstr "このプロパティを設定するには、このページの既存の注釈を参照する必要があります。このプロパティを設定する際、後続の `update()` は不要です。" + +#: ../../annot.rst:185 ../../annot.rst:194 ../../annot.rst:214 +#: 947db9161dbc4a5abaf2c4e5c327c2a5 96611258f0aa4dc0bf207ae360d52788 +#: bd70bb769d2746b284efa08b35620bfd +msgid "New in v1.18.4" +msgstr "v1.18.4 で新たに追加" + +#: ../../annot.rst:187 31ae7a8ecd5f43d6ac946be9532c8f1b +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:189 c064d15b32e84ff8aacc7830c81b4785 +msgid "the desired open state." +msgstr "望ましい開いた状態。" + +#: ../../annot.rst:196 b0fb54a5008345b6a0ecefa92dc66f64 +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:198 2498a8aaab114ee1b8adac34c4eefd0b +msgid "the desired rectangle." +msgstr "望ましい矩形。" + +#: ../../annot.rst:204 3fe341f3444247d49256ba3202ff9054 +msgid "" +"Set the annotation's transparency. Opacity can also be set in " +":meth:`Annot.update`." +msgstr "注釈の透明度を設定します。透明度は :meth:`Annot.update` でも設定できます。" + +#: ../../annot.rst:206 422d216638ff42869a36815fdf24c725 +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:208 4d99ddd65f534841b9bd0620491395ca +msgid "Three overlapping 'Circle' annotations with each opacity set to 0.5:" +msgstr "透明度がそれぞれ 0.5 に設定された3つの重なる「Circle」注釈：" + +#: ../../annot.rst:216 56a1a767fb7643a4bf6ed086a86a70fc +msgid "" +"The annotation's blend mode. See :ref:`AdobeManual`, page 324 for " +"explanations." +msgstr "注釈のブレンドモード。詳細については :ref:`AdobeManual` 、ページ324を参照してください。" + +#: ../../annot.rst:219 2d772db649d840aebf5e824d2c81ce50 +msgid "the blend mode or *None*." +msgstr "ブレンドモードまたは *None* 。" + +#: ../../annot.rst:224 e4286765368f4f1e967e8655bbecc1fa +msgid "New in v1.16.14" +msgstr "v1.16.14 で新たに追加" + +#: ../../annot.rst:226 31a22b94c5d24c76bb6d9a9f758d1744 +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:228 79c3d84097f54e03bea6e473e57b2c9d +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:233 d9ed82b080f240719aa44b3f8b50335e +msgid "New in version 1.16.0" +msgstr "バージョン1.16.0で新たに追加" + +#: ../../annot.rst:235 338073f9c685498ea27382537f2f632b +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:237 12248bec971a410d80f9d4819e6bd81c +msgid "the new name." +msgstr "新しい名前。" + +#: ../../annot.rst:239 66346f820ba44887b02c75e6d2cf2c7e +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 " +"fontsize 20 must not exceed 190 pixels. So please make sure that the " +"following inequality is true: `fitz.get_text_length(text, " +"fontname=\"tibo\", fontsize=20) <= 190`." +msgstr "「Stamp」注釈の名前を設定した場合、これは矩形を **変更せず** 、テキストもレイアウトされません。:ref:`StampIcons` から標準のテキストを選択すると（ `\"STAMP_\"` の後の **正確な** 名前部分）、元のレイアウトが表示されるはずです。**任意** のテキストは大文字に変更されず、「Times-Bold」フォントで水平中央揃えで **1行** に表示され、収まるように短縮されます。テキストを完全に表示するには、フォントサイズ20を使用してのテキストの長さが190ピクセルを超えてはいけません。したがって、以下の不等式が成り立つことを確認してください: `fitz.get_text_length(text, fontname="tibo", fontsize=20) <= 190` 。" + +#: ../../annot.rst:243 8aad971d494f43e0854189d0c9871699 +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:245 5e7a21d507ea4bedbb42a4d9fe98b98c +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:247 acc6f7a3456c46ec9a5ca2df67ba86e8 +msgid "You **need not** invoke :meth:`Annot.update` for activation of the effect." +msgstr "効果の有効化には :meth:`Annot.update` を呼び出す **必要はありません** 。" + +#: ../../annot.rst:252 8e38f3fb4a03497faeb65c00c6aa345b +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:254 5c6253af3959405abc022dade5e322cf +msgid "" +"rotation angle in degrees. Arbitrary values are possible, but will be " +"clamped to the interval `[0, 360)`." +msgstr "度数法での回転角度。任意の値が可能ですが、区間 `[0, 360)` にクランプされます。" + +#: ../../annot.rst:257 28dcd865eac949b39506a5c6d1547474 +msgid "You **must invoke** :meth:`Annot.update` to activate the effect." +msgstr "効果を有効にするには、:meth:`Annot.update` を **呼び出す必要があります** 。" + +#: ../../annot.rst:258 93fa3d3c17ed446b8e54b07cf7d58a35 +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:259 cdbe65b4ac9d49ecaa4b86f8473b5d7e +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:264 daacc4e16f4b4ccba041e702ee5b2632 +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:266 645a12e3304a4efbaf7c6056908003a4 +msgid "Changed in version 1.22.5: Support of the \"cloudy\" border effect." +msgstr "バージョン1.22.5で変更: "cloudy"ボーダーエフェクトのサポート。" + +#: ../../annot.rst:268 02c156e9a9f94a6c96c7dbf6facdd72a +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:271 4790077e58984a03a0f3f969cc8d6e21 +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:273 9c67c3df7a154045a701325d0b555c4a +msgid "A non-negative value will change the border line width." +msgstr "非負の値はボーダーの線幅を変更します。" + +#: ../../annot.rst:274 bd313db5b61c4b2cae852a25a1d42e17 +msgid "A value other than `None` will change this border property." +msgstr "`None` 以外の値はこのボーダープロパティを変更します。" + +#: ../../annot.rst:275 8c948fd63f964fe6ad819ce156d09d27 +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:276 294d48e69f134d34882a590ae256a258 +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:280 bd8964a406d6477bb1d5188e1687c5d9 +msgid "Changes the annotation flags. Use the `|` operator to combine several." +msgstr "注釈のフラグを変更します。複数のフラグを組み合わせるには `|` 演算子を使用します。" + +#: ../../annot.rst:282 766360a25c6d4d93812f5aa01bb72bc0 +msgid "an integer specifying the required flags." +msgstr "必要なフラグを指定する整数。" + +#: ../../annot.rst:286 b6915a6f948f4c9892fb9b6848e2b52f +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* が辞書でない場合に使用されます。" + +#: ../../annot.rst:288 dfd086d5036d47bf91356e3b6d16b566 +msgid "" +"Changes the \"stroke\" and \"fill\" colors for supported annotation types" +" -- not all annotations accept both." +msgstr "サポートされている注釈タイプに対して「ストローク」と「塗りつぶし」の色を変更します – すべての注釈が両方を受け入れるわけではありません。" + +#: ../../annot.rst:290 bc57fa68ef69489caaf249950bd2b181 +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:291 ../../annot.rst:292 749bbdb3e9564365b73c1201067e24eb +#: 7b9a7baeea574614bb336d541b7ec904 +msgid "see above." +msgstr "上記を参照してください。" + +#: ../../annot.rst:294 f443539de5d14a239024115123791cd0 +msgid "" +"*Changed in v1.18.5:* To completely remove a color specification, use an " +"empty sequence like `[]`. If you specify `None`, an existing " +"specification will not be changed." +msgstr "*バージョン1.18.5で変更:* 色の仕様を完全に削除するには、`[]` のような空のシーケンスを使用してください。`None` を指定した場合、既存の仕様は変更されません。" + +#: ../../annot.rst:299 9e2180b758c14a2fb6d6e982f01deded +msgid "New in version 1.16.12" +msgstr "バージョン1.16.12で新規追加" + +#: ../../annot.rst:301 0e58bd8edcda4fc2b52bf49aad197328 +msgid "" +"Delete annotations referring to this one. This includes any 'Popup' " +"annotations and all annotations responding to it." +msgstr "この注釈を参照する注釈を削除します。これには「ポップアップ」注釈とそれに応答するすべての注釈が含まれます。" + +#: ../../annot.rst:315 5129ccbaafa545c584567f505483534e +msgid "" +"Synchronize the appearance of an annotation with its properties after " +"relevant changes." +msgstr "関連する変更後に注釈の外観をプロパティに同期させます。" + +#: ../../annot.rst:317 b0401306e308472abd7d5a0abe6617bd +msgid "You can safely **omit** this method **only** for the following changes:" +msgstr "以下の変更に関して **のみ** 、このメソッドを安全に **省略できます** :" + +#: ../../annot.rst:323 91ddd1ac71474443893f38cbc753477f +msgid ":meth:`Annot.set_info` (except any changes to *\"content\"*)" +msgstr ":meth:`Annot.set_info` （*「content」* 以外の変更を除く）" + +#: ../../annot.rst:325 450c4d27706e4c71810c8e03c8eedeac +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:327 0acfbc2ec560443bbc4c3febdd7a4e09 +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:329 1b96aa7531af4910bc500e21125a260d +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:330 fe23121ecc22459789cb5326f77b1207 +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:331 b9a936e1126d4e0c88339403023b57c3 +msgid "change font size of the text. 'FreeText' annotations only." +msgstr "テキストのフォントサイズを変更します。 'FreeText' 注釈のみです。" + +#: ../../annot.rst:332 a1a2d104610b4bb9931755aa04666f15 +msgid "change the text color. 'FreeText' annotations only." +msgstr "テキストの色を変更します。 'FreeText' 注釈のみです。" + +#: ../../annot.rst:333 fcaa278604f14d30bfc8945a7bf039cf +msgid "change the border color. 'FreeText' annotations only." +msgstr "境界線の色を変更します。 'FreeText' 注釈のみです。" + +#: ../../annot.rst:334 f9f62eb374154f5688abf7c2b7623aad +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 "" + +#: ../../annot.rst:334 4854bc60e3ba45febba7b58fd6063f3a +msgid "the fill color." +msgstr "塗りつぶしの色です。" + +#: ../../annot.rst:336 ef919587b82742bf9e78288b5c97390a +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で変更）* 。" + +#: ../../annot.rst:338 e6f4dc396774426db932e45236cf6834 +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:339 6f38bd4316ea459d9e7e5ac6c5765e83 +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:343 aa8949d961b247c8a52688427a4211da +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:348 83280f0b2edd4a27abf953804f7e5004 +msgid "Basic information of the annot's attached file." +msgstr "アノットが添付されたファイルの基本情報。" + +#: ../../annot.rst:351 0ab52508437d46709e4af04c37a7bdd3 +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:355 e75299db9eaa4a09b28c900ef2038b24 +msgid "Returns attached file content." +msgstr "添付ファイルの内容を返します。" + +#: ../../annot.rst:358 f03024c0d5054b268a9c4eed5d7c2a8e +msgid "the content of the attached file." +msgstr "添付ファイルの内容。" + +#: ../../annot.rst:368 46973126c129496d9cccae299e907fb4 +msgid "" +"Updates the content of an attached file. All arguments are optional. No " +"arguments lead to a no-op." +msgstr "添付ファイルの内容を更新します。すべての引数はオプションです。引数が指定されない場合、操作は行われません。" + +#: ../../annot.rst:370 2de521c55f3d4a77b9f15a3f552d4e86 +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:370 da2d292308a74b3ebdc733efb99920ed +msgid "the new file content. Omit to only change meta-information." +msgstr "新しいファイルの内容。メタ情報のみ変更する場合は省略します。" + +#: ../../annot.rst:372 7530bb1e887647e6a87ec7650a49fb0f +msgid "*(Changed in version 1.14.13)* *io.BytesIO* is now also supported." +msgstr "*（バージョン1.14.13で変更）io.BytesIO* もサポートされるようになりました。" + +#: ../../annot.rst:374 952fdd67a1324a50833a656a1178f310 +msgid "new filename to associate with the file." +msgstr "ファイルに関連付ける新しいファイル名。" + +#: ../../annot.rst:376 589ed063f5bc4f589509f00b0aef57d1 +msgid "new unicode filename to associate with the file." +msgstr "ファイルに関連付ける新しいUnicodeファイル名。" + +#: ../../annot.rst:378 0f19fc2f0ec9482dbbe2063ae2c6e5e2 +msgid "new description of the file content." +msgstr "ファイル内容の新しい説明。" + +#: ../../annot.rst:382 7cbef5f8586b4506b0ed59090e57aec3 +msgid "Return the embedded sound of an audio annotation." +msgstr "オーディオアノテーションの埋め込まれた音声を返します。" + +#: ../../annot.rst:385 910c4bf546e24b80ab969a1df04cb1b7 +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:385 86deb7977a8047e1b297f637a832a687 +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:388 9629a8e5b9894f839d0d1386e85f2158 +msgid "Key" +msgstr "キー" + +#: ../../annot.rst:388 1ea199a943094b54adaafa23459ffd97 +msgid "Description" +msgstr "説明" + +#: ../../annot.rst:390 c3eabbc0cc28413a9b1404a6e766f8f2 +msgid "rate" +msgstr "" + +#: ../../annot.rst:390 99eaf259b71e45fc9bebb7a442517079 +msgid "(float, requ.) samples per second" +msgstr "(float, 必須) 1秒あたりのサンプル数" + +#: ../../annot.rst:391 2c1043757abd4370870538ee4ca5072e +msgid "channels" +msgstr "" + +#: ../../annot.rst:391 46afbd0075cf49289183b80de2c6e5ac +msgid "(int, opt.) number of sound channels" +msgstr "(int, オプション) サウンドチャンネルの数" + + +#: ../../annot.rst:392 21a8e7ff779644e3a307067bcac0b837 +msgid "bps" +msgstr "" + +#: ../../annot.rst:392 b30e4484dd3247ffb6f7ca7323e69bb5 +msgid "(int, opt.) bits per sample value per channel" +msgstr "(int, オプション) チャンネルごとのサンプル値のビット数" + +#: ../../annot.rst:393 8931170bced14233ba66d366a0e6b9ef +msgid "encoding" +msgstr "" + +#: ../../annot.rst:393 78793d1973c54d34a8a1b148b7c37e68 +msgid "(str, opt.) encoding format: Raw, Signed, muLaw, ALaw" +msgstr "(str, オプション) エンコーディング形式: Raw, Signed, muLaw, ALaw" + +#: ../../annot.rst:394 9b9da73f1a6c4bf68c429a2d3115077b +msgid "compression" +msgstr "" + +#: ../../annot.rst:394 d8dab06f9295426e8ac395f71d6e3916 +msgid "(str, opt.) name of compression filter" +msgstr "(str, オプション) 圧縮フィルタの名前" + +#: ../../annot.rst:395 330dbd6b6da44f6499c2170761861439 +msgid "stream" +msgstr "" + +#: ../../annot.rst:395 0e11d94ac25c480f976974659d53a1cd +msgid "(bytes, requ.) the sound file content" +msgstr "(bytes, 必須) サウンドファイルの内容" + +#: ../../annot.rst:401 2356e90e8be34c2195d38a6a896d681e +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:407 99a936b6eee5459ca0a9e266618886bc +msgid "The owning page object of the annotation." +msgstr "アノテーションの所属ページオブジェクト。" + +#: ../../annot.rst:409 28fa752ed6994c0697c764b99b9ca61b +msgid ":ref:`Page`" +msgstr "" + +#: ../../annot.rst:413 3fe47ed82cbc40439231ffbefd6eacf5 +msgid "The annot rotation." +msgstr "アノテーションの回転角度。" + +#: ../../annot.rst:416 cc43e14633a242f99f02425afffe338d +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:420 b148bcf66d6a4bda9cff82f90479d76e +msgid "The rectangle containing the annotation." +msgstr "アノテーションを含む長方形領域。" + +#: ../../annot.rst:422 ../../annot.rst:519 4b9273ccf01340158a9c499a688c8dc3 +#: abec38ac2ba245889a467010980c978a +msgid ":ref:`Rect`" +msgstr "" + +#: ../../annot.rst:426 1187682643804cab8903788992774579 +msgid "The next annotation on this page or None." +msgstr "このページ上の次のアノテーションまたはNone。" + +#: ../../annot.rst:428 e224f148714b422cbd5d5bbd23b175d1 +msgid "*Annot*" +msgstr "" + +#: ../../annot.rst:432 7f9805386f3a4d7e965c89bc04b44b2b +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:438 b38c0e85dfca4421a29effc836066e27 +msgid "" +"A dictionary containing various information. All fields are optional " +"strings. For information items not provided, an empty string is returned." +msgstr "異なる情報を含む辞書。すべてのフィールドはオプションの文字列です。提供されない情報項目については、空の文字列が返されます。" + +#: ../../annot.rst:440 a807f17849e349cb9c610d3d5babbbb8 +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:442 49865cb4a1b34222ad521c97fa2a9690 +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:444 651297aa49a24f6697c93b0260ea9576 +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:446 4843aed7f0f543258a352b51629a988b +msgid "*creationDate* -- creation timestamp." +msgstr "*creationDate* – 作成タイムスタンプ。" + +#: ../../annot.rst:447 3aec9555d0c944f2a5812fd732d6adc0 +msgid "*modDate* -- last modified timestamp." +msgstr "*modDate* – 最終変更タイムスタンプ。" + +#: ../../annot.rst:448 0f24aa24858e4ea39fe4de86d80fa0ca +msgid "*subject* -- subject." +msgstr "*subject* – 主題。" + +#: ../../annot.rst:449 840c3dcf796c44f5b10345877145207d +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:456 8c5b2edf73d649a591c0bc3d95d0c99b +msgid "" +"An integer whose low order bits contain flags for how the annotation " +"should be presented." +msgstr "注釈の表示方法を示すフラグを含む低位ビットを持つ整数。" + +#: ../../annot.rst:462 97f755cdf47a4bd0b1d28b496f963dc1 +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:468 8df8af27e997405fa80f5d6ca9697c02 +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:470 c0382f9df56043c7a7172613ca0515c8 +msgid "'Line' -- the starting and ending coordinates (2 float pairs)." +msgstr "'Line' – 開始座標と終了座標（2つの浮動小数点数のペア）。" + +#: ../../annot.rst:471 dda2751668ca4ae4a2367b5c87040d47 +msgid "" +"'FreeText' -- 2 or 3 float pairs designating the starting, the (optional)" +" knee point, and the ending coordinates." +msgstr "'FreeText' – 開始座標、（オプションの）曲線点、および終了座標を指定する2または3つの浮動小数点数のペア。" + +#: ../../annot.rst:472 be4be8ba66d44049a410e1330332ac3c +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:473 5333c5ab042f43ed9241dc14238ff225 +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:474 152d320c7410433689f7ba521e414141 +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:481 0c7b324656024002a7cb05c8f4cbaf5d +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." +msgstr "*0 <= 浮動小数点数 <= 1の範囲内* で指定された "ストローク" および内部（"塗りつぶし"）カラーの2つの浮動小数点数のリストから成る辞書。ストロークカラーは、境界線やアクティブに塗装されたり書かれたりするすべてに使用されます。塗りつぶしカラーは、線の端、円、正方形などのオブジェクトの内部に使用されます。これらのリストの長さは、暗黙的に使用されるカラースペースを決定します：1 = GRAY、3 = RGB、4 = CMYK。したがって、\"[1.0, 0.0, 0.0]\" はRGBカラーの赤を表します。どちらのリストも指定されていない場合、空にすることができます。" + +#: ../../annot.rst:487 573fa07263de48da9389dc6e50f01080 +msgid "The PDF :data:`xref`." +msgstr "PDFの :data:`xref` 。" + +#: ../../annot.rst:493 b67fe83930144e2fb74ad12d83287479 +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:499 d937038795da4dc19dc9ffea201475f5 +msgid "" +"The PDF :data:`xref` of the associated Popup annotation. Zero if non-" +"existent." +msgstr "関連するポップアップ注釈のPDF :data:`xref` 。存在しない場合はゼロ。" + +#: ../../annot.rst:505 61567d6ad66d4d0f8099e467ff8a2f91 +msgid "Whether the annotation has a Popup annotation." +msgstr "注釈にポップアップ注釈があるかどうか。" + +#: ../../annot.rst:511 26a210c5806b42b89c09ebdc85debe13 +msgid "" +"Whether the annotation's Popup is open -- **or** the annotation itself " +"('Text' annotations only)." +msgstr "注釈のポップアップが開いているかどうか - **または** 注釈自体（'テキスト'注釈のみ）。" + +#: ../../annot.rst:517 ea9e9383dafe4d5f8561560d9719587e +msgid "" +"The rectangle of the associated Popup annotation. Infinite rectangle if " +"non-existent." +msgstr "関連するポップアップ注釈の矩形。存在しない場合は無限の矩形。" + +#: ../../annot.rst:523 2946f70e4f5740178e85c50ecea68914 +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:527 86ac96ea95b24b45a6e3609c77c1794e +msgid "" +"A dictionary containing border characteristics. Empty if no border " +"information exists. The following keys may be present:" +msgstr "境界線の特性を含む辞書。境界線情報が存在しない場合は空です。次のキーが存在する可能性があります：" + +#: ../../annot.rst:529 eb1e6509e23d449c8c2cbf9b4f13ba9f +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:531 c3f0349738d94232b4ae68cc4d1526d3 +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:533 0362514acff348d2b534d44b2018f340 +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:535 133c794095db4653b2bd01ddc4297c6d +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:543 d76b6cbb0c8b40dc8cfbf4d44c16be3d +msgid "Annotation Icons in MuPDF" +msgstr "MuPDFの注釈アイコン" + +#: ../../annot.rst:544 4a05c0579c2b4b9aa19d203a45cdde25 +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:550 53d5a649e207449f91a46c8fa5d9f828 +msgid "Example" +msgstr "例" + +#: ../../annot.rst:551 8d81e4a7b9204709a92f3087f93d05d0 +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:574 5b4ec2421b4f49e4a1e5e22b9b687a56 +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:576 25282fb048634f58b32e3d312cda8f15 +msgid "|circle|" +msgstr "" + +#: ../../annot.rst:578 53f87c9e9e8740cbb4190a6d47eea16a +#: 5e5dcf34c06e4e13ae469dd09f1c4da0 +msgid "circle" +msgstr "" + +#: ../../annot.rst:582 8c9c1b484cad4a6094af529cebb63e87 +msgid "Footnotes" +msgstr "脚注" + +#: ../../annot.rst:583 84c0227ad1a2483c80d493fec7c2ff80 +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:585 49e7a791420e452baa38f0513143152b +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:-1 9e204c3d1dc34d338694c26828804f03 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/app1.mo b/docs/locales/ja/LC_MESSAGES/app1.mo new file mode 100644 index 000000000..5d0e14fb3 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/app1.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/app1.po b/docs/locales/ja/LC_MESSAGES/app1.po new file mode 100644 index 000000000..b1ffba529 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/app1.po @@ -0,0 +1,623 @@ +# 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" + +#: ../../app1.rst:7 4068765b43a540a08f8057acf1824e3a +msgid "Appendix 1: Details on Text Extraction" +msgstr "付録1: テキスト抽出の詳細" + +#: ../../app1.rst:8 5e4ee50f0bfa4d8a870f54fdcdc4178b +msgid "" +"This chapter provides background on the text extraction methods of " +"PyMuPDF." +msgstr "この章では、PyMuPDFのテキスト抽出メソッドに関する背景情報を提供します。" + +#: ../../app1.rst:10 ebe65558c3ff4e3ba56dffce2f58b55d +msgid "Information of interest are" +msgstr "興味のある情報は以下です" + +#: ../../app1.rst:12 228b4b8311db4d1b8a5baccbcc66e3ba +msgid "what do they provide?" +msgstr "彼らは何を提供するのか？" + +#: ../../app1.rst:13 d4a1d20bb9db4989b93e4d8ca0b19116 +msgid "what do they imply (processing time / data sizes)?" +msgstr "それらは何を意味するのか（処理時間 / データサイズ）？" + +#: ../../app1.rst:16 694ea055be454474b1e9e079d3f878f0 +msgid "General structure of a TextPage" +msgstr "TextPageの一般的な構造" + +#: ../../app1.rst:17 7683a5f81284475fb976dcf22d113536 +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 18237b66c5f64766bf3580dabe29508e +msgid "A **text page** consists of blocks (= roughly paragraphs)." +msgstr "**テキストページ** は、ブロック（おおよそ段落）で構成されています。" + +#: ../../app1.rst:29 e7676c139d5347df83d503787d6ef400 +msgid "A **block** consists of either lines and their characters, or an image." +msgstr "**ブロック** は、行とその文字、または画像のいずれかから成り立っています。" + +#: ../../app1.rst:31 7de8573ace61426883ffb214106234c5 +msgid "A **line** consists of spans." +msgstr "**行** は、スパンから成り立っています。" + +#: ../../app1.rst:33 6638f07e513a459b93879af7f8707de7 +msgid "" +"A **span** consists of adjacent characters with identical font " +"properties: name, size, flags and color." +msgstr "**スパン** は、同一のフォントプロパティ（名前、サイズ、フラグ、色）を持つ隣接する文字から成り立っています。" + +#: ../../app1.rst:36 c766f61501e1442e8557c6457cc2b087 +msgid "Plain Text" +msgstr "プレーンテキスト" + +#: ../../app1.rst:38 7e402454924d410faf38de97d841aa37 +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 100fd58ac1b5476c898556ee63ca991e +msgid "An example output::" +msgstr "例の出力：" + +#: ../../app1.rst:45 c0e1243dd6b542bca236d8b4e77773d4 +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:336 1d268791d9184bd69e5f7304e149d5cc +#: 3f7f192b38754e16b94ef04e98c39c84 +msgid "BLOCKS" +msgstr "ブロック" + +#: ../../app1.rst:51 61376463e9cc4e39922f387afd9b0354 +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 0b61a5656baf4b6bbea67997a8b7d477 +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 235d5eb541724ae0b5e3458ceab505b8 +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 82892ba8ea4341d19df65446d0d05321 +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 5f6acffb64114e55b19447e1d44b0fa9 +#: 668af4cd8028431cbccdde966932b4a9 +msgid "Example output::" +msgstr "例の出力：" + +#: ../../app1.rst:69 ../../app1.rst:337 3c333544424c4605b51e0e673d59f31b +#: 7a68d7c3e6e64348bc70688646fa260d +msgid "WORDS" +msgstr "単語" + +#: ../../app1.rst:71 be3f8ad8ecd844cf8181a79f8dc6074d +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 3cf37d89c58d4e30b600373abc5d6610 +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 244e1fe61cd94446b631dc8399b64f50 +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:340 3f7369adddcc41af9ed8f3747d63c9ab +#: ab04f64bd93e4ba38c7858e41c37e1eb +msgid "HTML" +msgstr "" + +#: ../../app1.rst:97 ccc74faf3ad949409fee1541d0a9d26f +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 aaa78831137746b0b7e14585e6ca25c8 +msgid "Controlling Quality of HTML Output" +msgstr "HTML出力の品質の制御" + +#: ../../app1.rst:114 29323ccbc9a849abb2bf222cbf75268d +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 7e209c32ed6a45878b03296b4741e5a5 +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 f82f22dc434b4f33a38bac8e49c0d9da +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 8b80053fd0544be2957535f4602b2c3e +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 accbb3a46e88406fb3c74ac8e44e6dae +msgid "DICT (or JSON)" +msgstr "DICT（またはJSON）" + +#: ../../app1.rst:162 da108bf5a1e5494ea4b1461483c23096 +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 dfd23d480486409dbfd3b8951c428e5b +msgid "" +"For a visualization of the dictionary structure have a look at " +":ref:`textpagedict`." +msgstr "辞書の構造の可視化については、辞書出力の構造をご覧ください。" + +#: ../../app1.rst:166 604467a19d284a8eab3653951f43a508 +msgid "Here is how this looks like::" +msgstr "以下がその様子です：" + +#: ../../app1.rst:192 5a48ee5893d44dd0ab30accb59c54027 +msgid "RAWDICT (or RAWJSON)" +msgstr "RAWDICT（またはRAWJSON）" + +#: ../../app1.rst:193 28bde68d6e0147ae94eb5ea87e110998 +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:338 7d8f3bdc5bd44d8790ff7fafc00fd352 +#: abb513b4c34f4896a85563fd643012c4 +msgid "XML" +msgstr "" + +#: ../../app1.rst:226 d2b501231099484697e649939274e50d +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 3561edf1013b4d7bbf3433f9b838475d +msgid "" +"We have successfully tested `lxml `_ to " +"interpret this output." +msgstr "この出力を解釈するためにlxmlを使用して正常にテストしました。" + +#: ../../app1.rst:258 ../../app1.rst:339 735c351f75f94ba6b763233fe8d5b309 +#: 92390c1a8a29446d8155f54f57f0194b +msgid "XHTML" +msgstr "" + +#: ../../app1.rst:259 f569e6e818554427866da876aa8e7fd0 +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 62a79ee9700a4f15a1905432115482e1 +msgid "Text Extraction Flags Defaults" +msgstr "テキスト抽出フラグのデフォルト値" + +#: ../../app1.rst:269 52ccc281a39946ac8cbb01b029e3edf5 +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 71334a9200f642c5bbd6356cc9f17c77 +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 f559200c78de42ed9ed74e9708510c47 +msgid "**include** images in a \"blocks\" output:" +msgstr "「blocks」出力に画像を **含める** 場合：" + +#: ../../app1.rst:275 7e800757cc344d86a7c9eee2b01cd477 +msgid "`flags = TEXTFLAGS_BLOCKS | TEXT_PRESERVE_IMAGES`" +msgstr "" + +#: ../../app1.rst:277 b35e0eb8ffc8432290cd908d6dc5cf63 +msgid "**exclude** images from a \"dict\" output:" +msgstr "「dict」出力から画像を **除外する** 場合：" + +#: ../../app1.rst:279 cf3f815ee21b4c029aae2d4649035d67 +msgid "`flags = TEXTFLAGS_DICT & ~TEXT_PRESERVE_IMAGES`" +msgstr "" + +#: ../../app1.rst:281 52d4534bfb40442b90685be566b6741d +msgid "set **dehyphenation off** in text searches:" +msgstr "テキスト検索での **ハイフネーション** をオフに設定する：" + +#: ../../app1.rst:283 ded7113b12b443d6ba88951accaef386 +msgid "`flags = TEXTFLAGS_SEARCH & ~TEXT_DEHYPHENATE`" +msgstr "" + +#: ../../app1.rst:287 f63bd504e23d46a997360ff9d804b111 +msgid "Indicator" +msgstr "指標" + +#: ../../app1.rst:287 c75be4a4f42745c8b924cc89e35a5559 +msgid "text" +msgstr "" + +#: ../../app1.rst:287 0bee13626aab4e36a3a0928fdd269e3c +msgid "html" +msgstr "" + +#: ../../app1.rst:287 9765468dfe654594a4d2a14b70382d1e +msgid "xhtml" +msgstr "" + +#: ../../app1.rst:287 640d37a600874d9ea02a8d0503520177 +msgid "xml" +msgstr "" + +#: ../../app1.rst:287 108b79e3108544f3961e075cd3a46273 +msgid "dict" +msgstr "" + +#: ../../app1.rst:287 f8c05e4cea8f492abc7dc523e020e64f +msgid "rawdict" +msgstr "" + +#: ../../app1.rst:287 4a1e8d44896d43219d72da952e1b1a38 +msgid "words" +msgstr "" + +#: ../../app1.rst:287 d20a27b512bf4725a9f1aa147850bba4 +msgid "blocks" +msgstr "" + +#: ../../app1.rst:287 ef5ba83491b2492dabaf9be8d4ae8259 +msgid "search" +msgstr "" + +#: ../../app1.rst:289 0fe2463f32844af9a68591db1bbfc21e +msgid "preserve ligatures" +msgstr "連結を保持" + +#: ../../app1.rst:289 ../../app1.rst:290 ../../app1.rst:291 ../../app1.rst:293 +#: ../../app1.rst:294 0070ec6871fd425594d704d5ab3bf8da +#: 0f38422c9ed5436aa14afaa0c205bf8f 1617523e88b54ce590f23ed3bf76cde6 +#: 1a070120fb324151b0a1996959208d76 1aa13bd7b47b4e8a90bbeb38f3646484 +#: 1cf61da927db4772bd2a3b6eadda89c4 1f9f1ac4b4664b80a6981ca9bb9ca616 +#: 205111cfb83a4c328f8d2d5ebbf79d4d 23160bb73fc14a4a96fc36086dc641e9 +#: 44fae69411cf4594bd595c1c88eaae63 4786abb98fb145c69864b5a17262601d +#: 48e00dc7b9974d2e9396570c619e8f25 4b3b090dfb704d6c852ad6c13716ba8b +#: 4dd3f6e44dd64ccbbdeccbbc2f6e9a05 55534f7fef2343418f03926daa9c3609 +#: 66dbbc45f16d48cc9b59d261d1516fbc 69ce93f4df8f4c64a6f480ee09641153 +#: 6bc6836be9984b8698584c85a5ce27c9 71733a1dc0e842fdb3d0e8696fd0c2d2 +#: 745e2ab8888a49a8a65474d776cf9fcc 80f48f20bed543a0b0a5dc0b581d8043 +#: 9abb6daef17c46faac96d4487d81091c 9b2eef3cc7874693bd041bbb80e89c41 +#: 9d2e18db0db84954a9cf32fe921b8c12 a6bf39ca82a74232a40f6d771c634e05 +#: bdf0224621df4fd687ef1b680583f7b7 c12c6a507d56437c92edbde7d9553cf9 +#: cfdb74c39aa244fc862158f67cea9a96 e4fb6f1c46b345bfb8a3fc96ab37f450 +#: ec42484eab3c4fd1ad6ead9bc01688cc f79f92ae07c94f2db1111a473289e77e +#: fdde625febf148bf8d9399475f236df1 +msgid "1" +msgstr "" + +#: ../../app1.rst:290 b803dfcee6e6467cbf4b6a7952ca8943 +msgid "preserve whitespace" +msgstr "空白を保持" + +#: ../../app1.rst:291 223f7653e2a3423a9a9d51a147ae457b +msgid "preserve images" +msgstr "画像を保持" + +#: ../../app1.rst:291 0237110b1f7c4f46a0255de6aede8a7a +#: b0f53f07fa0f45dfbf0662ea1e86717c ff9aaf7df6ad46349e87a31707a7b487 +msgid "n/a" +msgstr "" + +#: ../../app1.rst:291 ../../app1.rst:292 ../../app1.rst:293 +#: 16d904d5a4844da8b86942ac4f7a1dc0 236b874d90674660a6fac3921aaff01e +#: 320a25f09b14498bb8a02116b95b5602 394a697d8ffb41ff9f9d8a5935778fd7 +#: 3b7f74eb8d46460496b59740af57fd5d 484c13a33655450bb557d8c44511e7dc +#: 6eb7d76d0bd842b68583158cd1d6442a 6f76c0b378c34b0d8377f04fe91e948b +#: 877473db8efc4bc68120542cbfa318fc 878e06af75404b7da037bc67d4921185 +#: 88d1ff06338f442988e791258d22e128 9019ce6d13024695829eb42b1b5a92eb +#: 9d6412b5f3034a2795e6ad445514e8b6 a89ba5cd814d433a9eadfc9af5db3cd3 +#: b3b0b42883ee4cedb84f0e1a023eefb5 c52223483cfe414484444419a6510c12 +#: cc93a2bb9e2941eb8a7b88d2220b0cdd e3df170ea012425eb30304149954b780 +#: f148b93ee4e840309fa0360082a9c1ce +msgid "0" +msgstr "" + +#: ../../app1.rst:292 327a761ea95f4a0f9f814bc898b49eed +msgid "inhibit spaces" +msgstr "スペースの抑制" + +#: ../../app1.rst:293 83349b0f5e34477c9daac09e19af11ae +msgid "dehyphenate" +msgstr "ハイフネーション解除" + +#: ../../app1.rst:294 314d7ef0a92f4525be7c469f4fe01af0 +msgid "clip to mediabox" +msgstr "メディアボックスにクリップ" + +#: ../../app1.rst:297 f805ff04e6044084941864eca443d381 +msgid "**search** refers to the text search function." +msgstr "**検索** はテキスト検索機能を指します。" + +#: ../../app1.rst:298 2a944f3e71894dddb294ae16ca0544d1 +msgid "**\"json\"** is handled exactly like **\"dict\"** and is hence left out." +msgstr "**「json」** は **「dict」** とまったく同様に処理されるため、省略されています。" + +#: ../../app1.rst:299 c65058d1a0c74723adfc11b277921e9d +msgid "" +"**\"rawjson\"** is handled exactly like **\"rawdict\"** and is hence left" +" out." +msgstr "**「rawjson」** は **「rawdict」** とまったく同様に処理されるため、省略されています。" + +#: ../../app1.rst:300 17654089eeb344b3a8cf9911726b9861 +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:301 b0d772e43ad045e19774962af42138ae +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:303 5909da20fbba4b31bb4e9c7c0d0106ee +msgid "To show the effect of *TEXT_INHIBIT_SPACES* have a look at this example::" +msgstr "`TEXT_INHIBIT_SPACES` の効果を示すために、この例をご覧ください：" + +#: ../../app1.rst:323 2177dc593e8a448e85026d65102f3d3b +msgid "Performance" +msgstr "パフォーマンス" + +#: ../../app1.rst:324 9924390521844618ba93ff78d7f6ff02 +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:326 e2f7fcc6df1b43798cf2d73c4fa4c834 +#, 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:328 0995b31778ef45a2a46c512c27f6120d +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:330 5891b408a34d4445b04d5aeb85e98a6c +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:333 429f79ec87824ffb95a7dd05f2f9a6f4 +msgid "Method" +msgstr "メソッド" + +#: ../../app1.rst:333 55a6ccb1c3bc4881888522bd5c10c0ba +msgid "RSpeed" +msgstr "平均相対" + +#: ../../app1.rst:333 ecf817af690e4fd89bdbbb04a5dd02bf +msgid "Comments" +msgstr "コメント" + +#: ../../app1.rst:333 e9aab714586d4f6d9c27d71fed35e4f3 +msgid "no images" +msgstr "画像なし" + +#: ../../app1.rst:335 f39e66d7f52647368816c1379ac7cf4b +msgid "TEXT" +msgstr "" + +#: ../../app1.rst:335 ../../app1.rst:336 ../../app1.rst:339 +#: 24938cf6a13c40bfbc44c83835175faf 8862ffeb1d6a45b6a579829f802df7ca +#: bbb17484ea17403e81649fdcc2ba74a3 c4a8768094974f7f932df4b4bb782629 +#: ea6a080c8f4844fb99bd269358e5fd31 +msgid "1.00" +msgstr "" + +#: ../../app1.rst:335 29274ba263c442559104c739326116c3 +msgid "no images, **plain** text, line breaks" +msgstr "画像なし、 **プレーン** テキスト、改行" + +#: ../../app1.rst:336 b97c7beeb1a24dac93eddea08b3ec88d +msgid "image bboxes (only), **block** level text with bboxes, line breaks" +msgstr "画像のバウンディングボックス（のみ）、 **ブロック** レベルのテキストとバウンディングボックス、改行" + +#: ../../app1.rst:337 8da9799dec2047c48db4fd73b273461a +#: 9a11a9e62ebd4e69b4c971b35987d1cb +msgid "1.02" +msgstr "" + +#: ../../app1.rst:337 456785345fe247149ee096d381d4b74b +msgid "no images, **word** level text with bboxes" +msgstr "画像なし、 **ワード** レベルのテキストとバウンディングボックス" + +#: ../../app1.rst:338 4be95ee55bb4427bbeabba7e8edd918e +#: d878bafc71784952840d88e3fd88ed0c +msgid "2.72" +msgstr "" + +#: ../../app1.rst:338 0cfe0f62ce9445a69db1bd171a43f4b2 +msgid "no images, **char** level text, layout and font details" +msgstr "画像なし、**文字** レベルのテキスト、レイアウトとフォントの詳細" + +#: ../../app1.rst:339 e6a5137a5db3443b83a0c5eb92666011 +msgid "3.32" +msgstr "" + +#: ../../app1.rst:339 265cf1a100c7472792c21d8aa245d017 +msgid "**base64** images, **span** level text, no layout info" +msgstr "**base64** 画像、 **スパン** レベルのテキスト、レイアウト情報なし" + +#: ../../app1.rst:340 be14e342b2cb4bbeaea9da93d4058b97 +msgid "3.54" +msgstr "" + +#: ../../app1.rst:340 533027d461294d299f1612b10a51e6a0 +msgid "**base64** images, **span** level text, layout and font details" +msgstr "**base64画像** 、 **スパン** レベルのテキスト、レイアウトとフォントの詳細" + +#: ../../app1.rst:340 0d4c44a1bc2b461ab8b127d4ecda8284 +msgid "1.01" +msgstr "" + +#: ../../app1.rst:341 28d2fbff0b984e12af5d2d873d35b39d +msgid "DICT" +msgstr "" + +#: ../../app1.rst:341 02771176c2624e50a30c77a7b6304ea1 +msgid "3.93" +msgstr "" + +#: ../../app1.rst:341 f59d56b5f2ee452ca3fddc720acbe905 +msgid "**binary** images, **span** level text, layout and font details" +msgstr "**バイナリ** 画像、 **スパン** レベルのテキスト、レイアウトとフォントの詳細" + +#: ../../app1.rst:341 52e25884bd174c7690a514b966c9f469 +msgid "1.04" +msgstr "" + +#: ../../app1.rst:342 d99f5c978ff64203b9e6079ac5741f92 +msgid "RAWDICT" +msgstr "" + +#: ../../app1.rst:342 2af1182d794c4142bc153dd562b0086b +msgid "4.50" +msgstr "" + +#: ../../app1.rst:342 7eff9659c5a249b9926b1ec4b6c8fb66 +msgid "**binary** images, **char** level text, layout and font details" +msgstr "**バイナリ** 画像、**文字** レベルのテキスト、レイアウトとフォントの詳細" + +#: ../../app1.rst:342 fe21011347d141aeb3faafcbb9c5b922 +msgid "1.68" +msgstr "" + +#: ../../app1.rst:345 23e6f9b8628a40eaa0535f5fea9977b1 +#, 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:347 7f9a7e5a6faa4f2288bc4d0371e7b861 +msgid "Look at chapter **Appendix 1** for more performance information." +msgstr "もっとパフォーマンス情報については、 **付録1章** をご覧ください。" + +#: ../../footer.rst:-1 b8f999e8d1184eccb20858b347f3daa2 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/app2.mo b/docs/locales/ja/LC_MESSAGES/app2.mo new file mode 100644 index 000000000..42f3867b7 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/app2.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/app2.po b/docs/locales/ja/LC_MESSAGES/app2.po new file mode 100644 index 000000000..ac2cb14e0 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/app2.po @@ -0,0 +1,118 @@ +# 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" + +#: ../../app2.rst:7 c5a1a1cefa674a0c9a1df55cda6a1bf4 +msgid "Appendix 2: Considerations on Embedded Files" +msgstr "付録2：埋め込みファイルに関する考慮事項" + +#: ../../app2.rst:8 3e3defa44d7b4b62b360469ff84c5c04 +msgid "" +"This chapter provides some background on embedded files support in " +"PyMuPDF." +msgstr "この章では、PyMuPDFにおける埋め込みファイルのサポートに関する背景情報を提供します。" + +#: ../../app2.rst:11 ee565406549243898cf52727c58154db +msgid "General" +msgstr "一般" + +#: ../../app2.rst:12 c86d39e023424d2d9804e9303a5e537c +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 ef43351e76cb44349fb1ebe24196f90a +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 8346e4f23fd94f85a8d538dbb0f6aba4 +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 6c5fa0f74dcd41f187241d6e11b6cc60 +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 1c550f33d907464bbe56f0d0f0f0cf5d +msgid "MuPDF Support" +msgstr "MuPDFのサポート" + +#: ../../app2.rst:23 bcdf947b13534811a7e9d1143a345792 +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 cc2dbce08b9948418c19367038d05f77 +msgid "" +"As a consequence, the cli utility *mutool* no longer offers access to " +"embedded files." +msgstr "その結果、cliユーティリティ *mutool* ではもはや埋め込みファイルにアクセスできなくなりました。" + +#: ../../app2.rst:27 cbb6b49f27614cf4a9f0c1ed3022263d +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 7c71ad039ebe4b20b7ac9015c103bc71 +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 8bd2cedc02944b80b24b2a6e169d505e +msgid "PyMuPDF Support" +msgstr "PyMuPDFのサポート" + +#: ../../app2.rst:33 daa9a9d8d9194b38844f5c668c0c73b2 +msgid "" +"We continue to support the full old API with respect to embedded files --" +" with only minor, cosmetic changes." +msgstr "私たちは、埋め込みファイルに関する古いAPIを、わずかな見た目の変更のみを行いながら引き続きサポートしています。" + +#: ../../app2.rst:35 719e71e784014d6faa3b8d27d8593490 +msgid "" +"There even also is a new function, which delivers a list of all names " +"under which embedded data are resgistered in a PDF, " +":meth:`Document.embfile_names`." +msgstr "また、PDF内の埋め込みデータが登録されているすべての名前のリストを返す新しい関数も存在します。:meth:`Document.embfile_names` です。" + +#: ../../footer.rst:-1 81453fff5bdd46448c17b05989460289 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/app3.mo b/docs/locales/ja/LC_MESSAGES/app3.mo new file mode 100644 index 000000000..c0e177cb6 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/app3.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/app3.po b/docs/locales/ja/LC_MESSAGES/app3.po new file mode 100644 index 000000000..70f41a997 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/app3.po @@ -0,0 +1,595 @@ +# 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" + +#: ../../app3.rst:7 33ca195713624e268960b866532abe1b +msgid "Appendix 3: Assorted Technical Information" +msgstr "付録3：さまざまな技術情報" + +#: ../../app3.rst:8 5d7604936669477a8543dc05f394f711 +msgid "" +"This section deals with various technical topics, that are not " +"necessarily related to each other." +msgstr "このセクションでは、必ずしも関連しないさまざまな技術的なトピックについて取り扱います。" + +#: ../../app3.rst:15 698afd719d9248b68cc78d0c514331a3 +msgid "Image Transformation Matrix" +msgstr "画像変換行列" + +#: ../../app3.rst:16 8f461cbb3aee4833a1c77838562def55 +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 4656e953d5f9422bae9cb2df769dad1c +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 aa05b1468af44158ad2cac26b679a64b +msgid "" +"The relationship between image dimension and its bbox on a page is the " +"following:" +msgstr "画像の寸法とページ上のbboxとの関係は次のとおりです：" + +#: ../../app3.rst:24 505829211c4241ed8436e7702ecb4e35 +msgid "Using the original image's width and height," +msgstr "元の画像の幅と高さを使用して、" + +#: ../../app3.rst:23 afc6aa25316a4306beacbffe6a3a3b08 +msgid "define the image rectangle `imgrect = fitz.Rect(0, 0, width, height)`" +msgstr "画像の矩形を `imgrect = fitz.Rect(0, 0, width, height)` と定義します。" + +#: ../../app3.rst:24 fe58a6e0cbec47918714a20520c60e34 +msgid "" +"define the \"shrink matrix\" `shrink = fitz.Matrix(1/width, 0, 0, " +"1/height, 0, 0)`." +msgstr "「縮小行列」を `shrink = fitz.Matrix(1/width, 0, 0,1/height, 0, 0)` と定義します。" + +#: ../../app3.rst:26 70023984ad2c492ab9233234842f8a72 +msgid "" +"Transforming the image rectangle with its shrink matrix, will result in " +"the unit rectangle: `imgrect * shrink = fitz.Rect(0, 0, 1, 1)`." +msgstr "画像矩形を縮小行列で変換すると、単位矩形が得られます： `imgrect * shrink = fitz.Rect(0, 0, 1, 1)` 。" + +#: ../../app3.rst:28 fec6c51054574cf8940a81ebe75a306e +msgid "" +"Using the image **transformation matrix** \"transform\", the following " +"steps will compute the bbox::" +msgstr "画像 **変換行列** 「transform」を使用して、次の手順でbboxを計算します：" + +#: ../../app3.rst:34 3c5328ada81748fa84ad503f7204eef5 +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 93862911aecc440b8d4589ed6e08db50 +msgid "PDF Base 14 Fonts" +msgstr "PDFベース14フォント" + +#: ../../app3.rst:72 5744a4d4df564eec89a75c6014847444 +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 db63a3bf8973449aacedd81967a27fb4 +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 40ff17b9c8784851aa9555bb17cd018f +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 96a83114ee56481ca444d925db24309b +msgid "Adobe PDF References" +msgstr "Adobe PDFリファレンス" + +#: ../../app3.rst:116 c5fb37f607b2467ca7af74b66883ab82 +msgid "" +"This PDF Reference manual published by Adobe is frequently quoted " +"throughout this documentation. It can be viewed and downloaded from `here" +" `_." +msgstr "Adobeによって公開されたこのPDFリファレンスマニュアルは、このドキュメンテーション全体で頻繁に引用されています。 `こちら `_ から閲覧およびダウンロードが可能です。" + +#: ../../app3.rst:118 794622b3f36a4feca4fb8df3a088759a +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ドキュメンテーションはこの文書を参照していました。私たちは、上記の現行仕様への参照を置き換える取り組みを行っています。" + +#: ../../app3.rst:125 055579409da441d49688fb684c94a9df +msgid "Using Python Sequences as Arguments in PyMuPDF" +msgstr "PythonシーケンスをPyMuPDFで引数として使用する場合" + +#: ../../app3.rst:126 33a686f0660f4a9d938fcdb81b0c2a12 +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 cc28166fe51e43bd8dd4862353d2409d +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 16c32014c0364f25806837e9a7887b29 +msgid "For example, specifying a sequence `\"s\"` in any of the following ways" +msgstr "例えば、次のいずれかの方法でシーケンス `\"s\"` を指定すると" + +#: ../../app3.rst:132 92e35b08c8354a8589255be2c0632791 +msgid "`s = [1, 2]` -- a list" +msgstr "`s = [1, 2]` – リスト" + +#: ../../app3.rst:133 fa714ca3b8a047d8b54ec3e9c30585be +msgid "`s = (1, 2)` -- a tuple" +msgstr "`s = (1, 2)` – タプル" + +#: ../../app3.rst:134 3edaef312ee94cb6a28fdc690faccd6c +msgid "`s = array.array(\"i\", (1, 2))` -- an array.array" +msgstr "`s = array.array(\"i\", (1, 2))` – array.array" + +#: ../../app3.rst:135 0f216dc877794ec7ac6d87f489165244 +msgid "`s = numpy.array((1, 2))` -- a numpy array" +msgstr "`s = numpy.array((1, 2))` – numpy配列" + +#: ../../app3.rst:136 217c10fe429b4a0db7aab1a6774bbfff +msgid "`s = bytearray((1, 2))` -- a bytearray" +msgstr "`s = bytearray((1, 2))` – bytearray" + +#: ../../app3.rst:138 0d35c5cad9a2496eb038df24e4f4dca2 +msgid "will make it usable in the following example expressions:" +msgstr "これによって、以下の例の式で使用可能になります：" + +#: ../../app3.rst:140 8940895f973043ffbfb11116e4849eb8 +msgid "`fitz.Point(s)`" +msgstr "" + +#: ../../app3.rst:141 5dfbd6c603374af386af13cbb05831d9 +msgid "`fitz.Point(x, y) + s`" +msgstr "" + +#: ../../app3.rst:142 248d1d9d4a8e491e8724e8952814d071 +msgid "`doc.select(s)`" +msgstr "" + +#: ../../app3.rst:144 08f875a418104cf8b5b443831a79374c +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 a7c65d60549f4a1c984f58c3a42fb2b7 +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 23165210c6244741a9ce6332eda74d2a +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 78acd4d431e341dd962f028050b264e5 +msgid "Ensuring Consistency of Important Objects in PyMuPDF" +msgstr "重要なオブジェクトの整合性を確保するためのPyMuPDF" + +#: ../../app3.rst:171 9ec97038963641cf9c77ce883b4b7e17 +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 358e188cabb04de490fe4f7f3f120c57 +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: " +"*fitz.py* and *fitz_wrap.c*. They are created by the excellent SWIG tool " +"for each new version." +msgstr "一方で、Pythonは非常にクリーンな方法でOOモデルを実装しています。PyMuPDFとMuPDFの間のインターフェースコードは、基本的に2つのファイルから構成されています： *fitz.py* と *fitz_wrap.c* 。これらは、新バージョンごとに優れたSWIGツールによって作成されます。" + +#: ../../app3.rst:175 1d4bde5f5e414fa4b2aaca07bec71664 +msgid "" +"When you use one of PyMuPDF's objects or methods, this will result in " +"execution of some code in *fitz.py*, which in turn will call some C code " +"compiled with *fitz_wrap.c*." +msgstr "PyMuPDFのオブジェクトやメソッドのいずれかを使用すると、これにより *fitz.py* でいくつかのコードが実行され、それがさらに *fitz_wrap.c* でコンパイルされたCコードを呼び出します。" + +#: ../../app3.rst:177 61133a4a341240ecbccbcaf3feae8dde +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 84bfc9102b9f40f89c037cfb5d6cf601 +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 270d6505474a4f9eb836eebf6ab9a782 +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 b1acb6e58964468ead03014ea3dfb41c +msgid "SWIG cannot know about this and consequently does not do it." +msgstr "SWIGはこれを知ることはできないため、それを実行しません。" + +#: ../../app3.rst:185 bb5d3b7fbef54e4fab7af5ea0db556b9 +msgid "" +"The required logic has therefore been built into PyMuPDF itself in the " +"following way." +msgstr "必要な論理はしたがって、PyMuPDF自体に以下のように組み込まれています。" + +#: ../../app3.rst:187 7003814b9cb14bdf9aba5b6239e784fb +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 096d5ae7233e4b3c919c467bf675491a +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 7b5d97b44da5443f9612ec0a963c4c46 +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 dc0506dd89d64f98a17c93c9aa9d2c95 +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 6620fbbe21184d1a8506a7e52d58bdf2 +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 e8df4fb66951412b937d7a63e0657541 +msgid "A sample session:" +msgstr "サンプルセッション：" + +#: ../../app3.rst:214 bea8af4d86c84f7096e87b9f4872b0a5 +msgid "This shows the cascading effect:" +msgstr "これは連鎖効果を示しています。" + +#: ../../app3.rst:231 87b5d6c22a184db0907f64f3b23243b5 +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 28be6e4896304aeaaf367d408afb2454 +msgid "Design of Method :meth:`Page.show_pdf_page`" +msgstr "メソッド :meth:`Page.show_pdf_page` の設計" + +#: ../../app3.rst:241 0573c0f0ce5742bb90a5075d494d5738 +msgid "Purpose and Capabilities" +msgstr "目的と機能" + +#: ../../app3.rst:243 97f7c9654077441c9b96c107f87c7786 +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 fa832dda8bca412e8d4884ab5c36c9ec +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 1c5113ba7b334b39aacdf3c71c365c11 +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 2794d785ea6f4754964fb7421a0af2c4 +msgid "The following variations of the display are currently supported:" +msgstr "現在、次のバリエーションの表示がサポートされています：" + +#: ../../app3.rst:250 6c6b636b457448ac915d21288df7638f +msgid "" +"Bool parameter `\"keep_proportion\"` controls whether to maintain the " +"aspect ratio (default) or not." +msgstr "Bool パラメーター `\"keep_proportion\"` はアスペクト比を保持するかどうかを制御します（デフォルト）。" + +#: ../../app3.rst:251 ad729b1cf23f45f78ce599a7b0f5b505 +msgid "" +"Rectangle parameter `\"clip\"` restricts the visible part of the source " +"page rectangle. Default is the full page." +msgstr "矩形パラメーター `\"clip\"` はソースページの矩形の可視部分を制限します。デフォルトはフルページです。" + +#: ../../app3.rst:252 bbe21508f39a4c8e9c47c8d42e06c788 +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 103b7790b22f43079d26ecaf727fc3a3 +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 cda7dd8ce6ad41cda2ec56124d76adeb +msgid "Use cases include (but are not limited to) the following:" +msgstr "使用例は以下のようなものがありますが、これに限定されません：" + +#: ../../app3.rst:257 b8ce554fb75a445fb6e9c017a18a973a +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 3c982e832912448ea84c5b93508b3638 +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 830b590a3c8e416d8d132f87020c90de +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 52a42578555a48ca8c94301e6a6cd7e0 +msgid "Technical Implementation" +msgstr "テクニカル実装" + +#: ../../app3.rst:264 09e5f5e308a84f9d8511818b5ffcdc82 +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 ce15260df9ed49d09a7e6e8b53d22f72 +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 fed99b8ac0dc45bcb28939d98f8ff226 +msgid "`/BBox` equals `/Mediabox` of the source page" +msgstr "`/BBox` はソースページの `/Mediabox` に等しいです。" + +#: ../../app3.rst:269 f7b845677736445f97969f076e069052 +msgid "`/Matrix` equals the identity matrix." +msgstr "`/Matrix` は単位行列と等しいです。" + +#: ../../app3.rst:270 b6f825c436d34fbeb2bdc7630df6e278 +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 93c85d00c89541699d33481f09cd3a0b +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 2834a7f762254412b36f8d0e45f2ddce +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 ae970441657e4bcaacab19e58abc5b7d +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 c95fad4b7da44ac0b44534432a399324 +msgid "`/BBox` equals the `/CropBox` of the source page (or `\"clip\"`)." +msgstr "`/BBox` はソースページの `/CropBox`（または `"クリップ"` ）に等しいです。" + +#: ../../app3.rst:278 709e8a03ef0648b9b0237f2d13e7aaf3 +msgid "`/Matrix` represents the mapping of `/BBox` to the target rectangle." +msgstr "`/Matrix` は `/BBox` からターゲット矩形へのマッピングを表します。" + +#: ../../app3.rst:279 e5aad1bf1c4841fb9ec83b65e0195dbb +msgid "" +"`/XObject` references the previous Form XObject via the fixed name " +"`fullpage`." +msgstr "`/XObject` は、以前のフォームXObjectを固定された名前 `fullpage` を介して参照します。" + +#: ../../app3.rst:280 13c9ef1d1f864eaaa19a2a16492c9a4c +msgid "" +"The stream of this object contains exactly one fixed statement: " +"`/fullpage Do`." +msgstr "このオブジェクトのストリームには、正確に1つの固定されたステートメントが含まれています： `/fullpage Do` 。" + +#: ../../app3.rst:281 15adfedf89e24757a94421572bc07587 +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 ca4a3b3bdf6f41cf9f689efcee4224cc +msgid "" +"The :data:`resources` and :data:`contents` objects of the target page are" +" now modified as follows." +msgstr "ターゲットページの :data:`リソース` と :data:`コンテンツ` オブジェクトは以下のように変更されます。" + +#: ../../app3.rst:285 efca8addf2f442a999367bdc630b53ac +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 7274a922d234436aa772aba08cd1cba9 +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 2fab5f6088074d2b9dd280aa6b267583 +msgid "This design approach ensures that:" +msgstr "この設計アプローチは次を保証します：" + +#: ../../app3.rst:290 353b1a2ba15949959a9e2da016c2ac06 +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 aa91782567f245af894a3573cb420677 +msgid "" +"Each referring target page can have its own `\"oc\"` parameter to control" +" the source page's visibility individually." +msgstr "参照する各ターゲットページは、ソースページの表示を個別に制御するための独自の `「oc」` パラメータを持つことができます。" + +#: ../../app3.rst:298 b91e7321758546f1bf2be546e74d0721 +msgid "Redirecting Error and Warning Messages" +msgstr "エラーと警告メッセージのリダイレクト" + +#: ../../app3.rst:299 ea9068813d034a9894e5bdfa987726d2 +msgid "" +"Since MuPDF version 1.16 error and warning messages can be redirected via" +" an official plugin." +msgstr "MuPDFバージョン1.16以降、エラーと警告メッセージは公式プラグインを介してリダイレクトできます。" + +#: ../../app3.rst:301 b494f2abdcfc4bffb97f4483b8d07755 +msgid "" +"PyMuPDF will put error messages to `sys.stderr` prefixed with the string " +"\"mupdf:\". Warnings are internally stored and can be accessed via " +"*fitz.TOOLS.mupdf_warnings()*. There also is a function to empty this " +"store." +msgstr "PyMuPDFはエラーメッセージを、先頭に文字列「mupdf:」を付けて `sys.stderr` に表示します。警告は内部で保存され、*fitz.TOOLS.mupdf_warnings()* を通じてアクセスできます。また、この保存領域を空にするための関数も存在します。" + +#: ../../app3.rst:305 99b427f7ce9e4e528d930311d02cde0a +msgid "Footnotes" +msgstr "脚注" + +#: ../../app3.rst:306 49ef9c0a37e24a3685cd3b28faff61ed +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:308 ae7161e9a4034459ad51b582d278f1e8 +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:309 42ac12d3ea0f4596b88ce4a2e737ad19 +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:-1 9ff4531737dd4caababe488f5de96325 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/app4.mo b/docs/locales/ja/LC_MESSAGES/app4.mo new file mode 100644 index 000000000..b86308f2a Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/app4.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/app4.po b/docs/locales/ja/LC_MESSAGES/app4.po new file mode 100644 index 000000000..d4a8cbc1b --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/app4.po @@ -0,0 +1,1093 @@ +# 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" + +#: ../../app4.rst:14 4a1e81ac1f0f495f98e107cebef3b1a6 +msgid "Appendix 4: Performance Comparison Methodology" +msgstr "付録4：性能比較方法" + +#: ../../app4.rst:16 4c3e578b97d544bc9a3df491df95c184 +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` の性能を測定するアプローチと、比較を行うために使用されるツールとサンプルファイルについて説明します。" + +#: ../../app4.rst:18 65992b6edec440d5b8cd2ad855311676 +msgid "The following three sections deal with different performance aspects:" +msgstr "以下の3つのセクションでは、異なる性能の側面に取り組んでいます：" + +#: ../../app4.rst:20 ef912ae97dab4a8bba8dfca25fbe77b0 +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:`ドキュメントのコピー` - これには :title:`PDF` ファイルの開閉と解析、そしてそれらを出力ファイルに書き込む作業が含まれます。同じ基本的なアクティビティは、:title:`PDF` ファイルの結合（マージ）にも使用されるため、結果はこれらのユースケースにも適用されます。" + +#: ../../app4.rst:21 0c99ef7b1c4545dca0cc386a1dda49d3 +msgid "" +":ref:`Text Extraction` - This extracts plain text " +"from :title:`PDFs` and writes it to an output text file." +msgstr ":ref:`テキスト抽出` - これにより :title:`PDF` ファイルから平文テキストが抽出され、テキストファイルに書き込まれます。" + +#: ../../app4.rst:22 8ce581173edf481d98f8ebeafbe64393 +msgid "" +":ref:`Page Rendering` - This converts :title:`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 fe5f9971743d4548bfe4b9f18c30474d +msgid "" +"Please note that in all cases the actual speed in dealing with " +":title:`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 " +":title:`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 ":title:`PDF` 構造の処理速度そのものを直接測定するのではなく、すべての場合において、タイミングにはファイルをオペレーティングシステムのファイルシステムに書き込む時間も含まれることに注意してください。これは回避できない要因です。なぜなら、:title:`PyMuPDF` 以外のツールでは、例えばイメージの **作成** ステップと、イメージをファイルに **書き込む** 後続のステップを分離するオプションが提供されていないためです。" + +#: ../../app4.rst:26 2d2d73cda2684e7785201a05ce329c91 +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 78490caee14746d8928902a963581d48 +msgid "Files used" +msgstr "使用されるファイル" + +#: ../../app4.rst:35 3605ae7c9069488b832c184f2494c069 +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 878bbefe08e94b999b48099a6879d6b5 +msgid "**Name** of the file and download **link**." +msgstr "ファイル **名** とダウンロード **リンク**。" + +#: ../../app4.rst:38 6934547cd869488684f8653db1d78925 +msgid "**Size** in bytes." +msgstr "バイト単位の **サイズ**。" + +#: ../../app4.rst:39 78a4f55d3c904546b355c8fc8f344adb +msgid "Total number of **pages** in file." +msgstr "ファイル内の総 **ページ** 数。" + +#: ../../app4.rst:40 996daa756f934560aee685307545e6e9 +msgid "Total number of bookmarks (**Table of Contents** entries)." +msgstr "ブックマーク（ **目次** エントリー）の総数。" + +#: ../../app4.rst:41 413a06231788471492472013a7e3652a +msgid "Total number of **links**." +msgstr "**リンク** の総数。" + +#: ../../app4.rst:42 ee37272a928b4f10a54b2774269e691b +msgid "**KB size** per page." +msgstr "ページごとの **KBサイズ** 。" + +#: ../../app4.rst:43 9b6478c67338486f9b73c929bd10a10e +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 e4511814c0224720b9ee4c5c0eb258fd +msgid "Any **notes** to generally describe the type of file." +msgstr "ファイルのタイプを一般的に説明するための **メモ** 。" + +#: ../../app4.rst:50 ../../app4.rst:217 ../../app4.rst:295 ../../app4.rst:407 +#: 3fd177d471d1440c811cc46a24394604 6fb60f10210f4c988357c3933b16e79d +#: 8366b5dba4da441c8cae1b3809a00593 97727bd687da4ad68a5fda6349a7bc01 +msgid "**Name**" +msgstr "**ファイル名** " + +#: ../../app4.rst:51 8e5d6865a9294ade9d75af43a8eb66a1 +msgid "**Size (bytes)**" +msgstr "**サイズ（バイト）** " + +#: ../../app4.rst:52 0899ed96a7554261a08141240a7a8b87 +msgid "**Pages**" +msgstr "**ページ数** " + +#: ../../app4.rst:53 a674051ef8d448adb4640a80c86a50d0 +msgid "**TOC size**" +msgstr "**目次サイズ** " + +#: ../../app4.rst:54 71c6e0a4d9214004b0d243aa3f29eef7 +msgid "**Links**" +msgstr "**リンク数** " + +#: ../../app4.rst:55 356dca82b8f045d38d33944210fbacd3 +msgid "**KB/page**" +msgstr "**KB/ページ** " + +#: ../../app4.rst:56 88f15dd129fc4b7486f2668046b8b365 +msgid "**Textsize/page**" +msgstr "**テキストサイズ/ページ** " + +#: ../../app4.rst:57 b84db499dead43aa8143bde0ea854211 +msgid "**Notes**" +msgstr "**メモ** " + +#: ../../app4.rst:58 53fab5550d494ff5bd74d2675825f613 +msgid "`adobe.pdf`_" +msgstr "" + +#: ../../app4.rst:59 27cade71b19146208e1d4e60ddd5bd62 +msgid "32,472,771" +msgstr "" + +#: ../../app4.rst:60 5ada3deeca61430198ba8bef9edec039 +msgid "1,310" +msgstr "" + +#: ../../app4.rst:61 931f8b738e654a3b9d7ac2b2a81ae52d +msgid "794" +msgstr "" + +#: ../../app4.rst:62 d5714630d3fa4154bc956aec8dc57cda +msgid "32,096" +msgstr "" + +#: ../../app4.rst:63 d753a6265534476db1644bded9a748ef +msgid "24" +msgstr "" + +#: ../../app4.rst:64 cee0ffcbc0f9417b9a6ce27464503bdc +msgid "1,942" +msgstr "" + +#: ../../app4.rst:65 2c988f08938a407b8c7f153907a8e68f +msgid "linearized, many links / bookmarks" +msgstr "線形化、多くのリンク/ブックマーク" + +#: ../../app4.rst:66 74d258d5966b413e8d47ea418ed006a7 +msgid "`artifex-website.pdf`_" +msgstr "" + +#: ../../app4.rst:67 eb52192a006349979a0c0cf305014aad +msgid "31,570,732" +msgstr "" + +#: ../../app4.rst:68 70b9d82a608440df97fef5e76ff4cde9 +msgid "47" +msgstr "" + +#: ../../app4.rst:69 3b799d8ad01b43b28bcf5fa3de43454b +msgid "46" +msgstr "" + +#: ../../app4.rst:70 5b1ea78eeceb4c2894f44714f186fb50 +msgid "2,035" +msgstr "" + +#: ../../app4.rst:71 bcbc3cf284db4a0db903a8b44ee54ffd +msgid "656" +msgstr "" + +#: ../../app4.rst:72 9af791bee5354025aef236894c4e50f7 +msgid "3,538" +msgstr "" + +#: ../../app4.rst:73 bf96d5f791f14511852943f5efcdde71 +msgid "graphics oriented" +msgstr "グラフィックス志向" + +#: ../../app4.rst:74 cddb476076f841199f799b8ce0ff9b11 +msgid "`db-systems.pdf`_" +msgstr "" + +#: ../../app4.rst:75 54f777a32133432daa3220e984ecbcf3 +msgid "29,326,355" +msgstr "" + +#: ../../app4.rst:76 7b009814e2a2434eabf951aee00c2782 +msgid "1,241" +msgstr "" + +#: ../../app4.rst:77 ../../app4.rst:78 ../../app4.rst:117 ../../app4.rst:118 +#: 28ec7b98ea16482cb5b123728880c449 33562aa03a1642eea3a2f4609800e688 +#: 53d0721533e24e8f81c2af4fa24443fa 6525009fb1844c5cb978dbf266e2ae12 +msgid "0" +msgstr "" + +#: ../../app4.rst:79 33d01d1cbbe0478db5891d182b0211c5 +msgid "23" +msgstr "" + +#: ../../app4.rst:80 b85bcdbbcf00425fba727575859ca95e +msgid "2,142" +msgstr "" + +#: ../../app4.rst:82 7a4799de47e94c9aa2753b9a70d191e6 +msgid "`fontforge.pdf`_" +msgstr "" + +#: ../../app4.rst:83 55986ba58bf74533942f85b95f47f849 +msgid "8,222,384" +msgstr "" + +#: ../../app4.rst:84 42de0e524f7d44c9aaa81b4856c80187 +msgid "214" +msgstr "" + +#: ../../app4.rst:85 000bbebf1850443c919611ef203b469a +msgid "31" +msgstr "" + +#: ../../app4.rst:86 6d050ec9c50b41198b653793bcd4228d +msgid "242" +msgstr "" + +#: ../../app4.rst:87 060a7623deac49dcb16145826da3c54c +msgid "38" +msgstr "" + +#: ../../app4.rst:88 eede32dd63d845afa8e09d5fdb634858 +msgid "1,058" +msgstr "" + +#: ../../app4.rst:89 1d26d20edef0444c82aab4449b86c6c1 +msgid "mix of text & graphics" +msgstr "テキストとグラフィックスのミックス" + +#: ../../app4.rst:90 10537b8385d748358485a334c0c5efd6 +msgid "`pandas.pdf`_" +msgstr "" + +#: ../../app4.rst:91 a410b18da6dc4bb89d1882539183e76c +msgid "10,585,962" +msgstr "" + +#: ../../app4.rst:92 5e004e5e9ca647d782b14f120346d868 +msgid "3,071" +msgstr "" + +#: ../../app4.rst:93 0d68b3a3aade4cc9b9386b46e12c3789 +msgid "536" +msgstr "" + +#: ../../app4.rst:94 49089510ac0b4de289e40334258fd8ff +msgid "16,554" +msgstr "" + +#: ../../app4.rst:95 9941b4144f4f47ba9bb5b86f45f194da +msgid "3" +msgstr "" + +#: ../../app4.rst:96 056553fbaea742c396355296e3bb15b0 +msgid "1,539" +msgstr "" + +#: ../../app4.rst:97 4e71b5363b5b42ddb83b1e603eec2f39 +msgid "many pages" +msgstr "多くのページ" + +#: ../../app4.rst:98 f24b4fcf8d954a4db2518c292961f957 +msgid "`pymupdf.pdf`_" +msgstr "" + +#: ../../app4.rst:99 beaae740bfff431d8498aad89fadb451 +msgid "6,805,176" +msgstr "" + +#: ../../app4.rst:100 743e18c7a26f471a9151c0f102af2b1b +msgid "478" +msgstr "" + +#: ../../app4.rst:101 5e4599410b964cb59df4a5b28acaee98 +msgid "276" +msgstr "" + +#: ../../app4.rst:102 69b3ac4638a9438287f172f34b66c67e +msgid "5,277" +msgstr "" + +#: ../../app4.rst:103 e9a527f549354d5f9af028d758849a0e +msgid "14" +msgstr "" + +#: ../../app4.rst:104 f623e630ba7e4502b2618393efb3b7b5 +msgid "1,937" +msgstr "" + +#: ../../app4.rst:105 5c107aa662324e46a00443b2fce06f0b +msgid "text oriented" +msgstr "テキスト志向" + +#: ../../app4.rst:106 5c902d91a7db4d87961462de8e4c38de +msgid "`pythonbook.pdf`_" +msgstr "" + +#: ../../app4.rst:107 958896ec1f1c4b85b806553bb3024ee3 +msgid "9,983,856" +msgstr "" + +#: ../../app4.rst:108 2128771e851a46099be090e1b3d42ca0 +msgid "669" +msgstr "" + +#: ../../app4.rst:109 7da607a6e5c344f7b1a5ab886644cc2a +msgid "198" +msgstr "" + +#: ../../app4.rst:110 77a633b9bca645a8ae5d35b5f0537d2c +msgid "1,953" +msgstr "" + +#: ../../app4.rst:111 ce76e6eb7ccd4aac8aac6ebdcb1ac675 +msgid "15" +msgstr "" + +#: ../../app4.rst:112 65b69b191afe4c27ac269dc72d9a2511 +msgid "1,929" +msgstr "" + +#: ../../app4.rst:114 0688d30672094117bed09291696e1e17 +msgid "`sample-50-MB-pdf-file.pdf`_" +msgstr "" + +#: ../../app4.rst:115 b87e7f92596842ee883267519e32794f +msgid "52,521,850" +msgstr "" + +#: ../../app4.rst:116 6a461fb70c9d4271b4ecc13dea547fb0 +msgid "1" +msgstr "" + +#: ../../app4.rst:119 37201416e86a4a85a3a75f9dd0fa3e0d +msgid "51,291" +msgstr "" + +#: ../../app4.rst:120 b7f6aa320b014148a49e5bdf72de31d8 +msgid "23,860" +msgstr "" + +#: ../../app4.rst:121 397f7cfb7a0c4ae18ea0c8545c46e7c6 +msgid "single page, graphics oriented, large file size" +msgstr "単一ページ、グラフィックス志向、大きなファイルサイズ" + +#: ../../app4.rst:127 b6e84732c7864afca79cf1147ffa35cc +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 e1d1a5c228f34d3ebc41c678b7b0a5f1 +msgid "Tools used" +msgstr "使用されるツール" + +#: ../../app4.rst:133 fabc818269d443cdb4fe1afe068c98de +msgid "" +"In each section, the same fixed set of :title:`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 "各セクションでは、同じ固定されたセットの :title:`PDF` ファイルが一連のツールによって処理されます。ただし、性能の側面ごとに使用されるツールのセットは、サポートされるツールの機能に応じて異なります。" + +#: ../../app4.rst:135 48b4241e8160435592bdf6b44f224b38 +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 87a8843195a545a9b42907a52f4b1652 +msgid "**Tool**" +msgstr "ツール" + +#: ../../app4.rst:142 8f0d2f4471244e7ead8e45fa1a2ef8a0 +msgid "**Description**" +msgstr "説明" + +#: ../../app4.rst:143 ../../app4.rst:172 ../../app4.rst:368 +#: 526195586b60487f8c2305974a30881a abf2669c3dd6411bb16a02a5cdfc8dd3 +#: b241360add424730adfe165c7158a290 +msgid ":title:`PyMuPDF`" +msgstr "" + +#: ../../app4.rst:144 312258c6e5234543816a927beca41aa8 +msgid "The tool of this manual." +msgstr "このマニュアルのツールです。" + +#: ../../app4.rst:145 e73677c6b0be4fa7b1f916d56f4184cc +msgid "PDFrw_" +msgstr "" + +#: ../../app4.rst:146 10ff13ac3aff4698b46ffa602c888fb1 +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 f4f7927f3db6432394269d7c671dc7fd +msgid "PyPDF2_" +msgstr "" + +#: ../../app4.rst:148 b9cc1dc2b5364458af4b03cde80bd4bc +msgid "A pure :title:`Python` tool with a large function set." +msgstr "多くの機能を備えた純粋な :title:`Python` ツールです。" + +#: ../../app4.rst:149 6e2028fb78cd4ed4a1d2d53f860dffc9 +msgid "PDFMiner_" +msgstr "" + +#: ../../app4.rst:150 f0f020f3b3c042feaebd09369c574800 +msgid "A pure :title:`Python` to extract text and other data from :title:`PDF`." +msgstr ":title:`PDF` からテキストやその他のデータを抽出するための純粋な :title:`Python` ツールです。" + +#: ../../app4.rst:151 2e52a4b0f839437fa503008a66e10e6d +msgid "XPDF_" +msgstr "" + +#: ../../app4.rst:152 fcb4e7ba8c81450d8b35ff9b3f7abff9 +msgid "A command line utility with multiple functions." +msgstr "複数の機能を備えたコマンドラインユーティリティです。" + +#: ../../app4.rst:153 da20b7a657ac4f3e943c2ea2d7f5b2ce +msgid "PikePDF_" +msgstr "" + +#: ../../app4.rst:154 930f5993e9b14457a73827762d9a5c21 +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 fde87f1a17e74dabb58fbc20079446cd +msgid "PDF2JPG_" +msgstr "" + +#: ../../app4.rst:156 1cb993521b4641d29df6e74868d16849 +msgid "" +"A :title:`Python` package specialized on rendering :title:`PDF` pages to " +":title:`JPG` images." +msgstr ":title:`PDF` ページを :title:`JPG` 画像にレンダリングすることに特化した :title:`Python` パッケージです。" + +#: ../../app4.rst:164 bdd439e571684818b0a479d6d904b205 +msgid "Copying / Joining / Merging" +msgstr "コピー / 結合 / マージ" + +#: ../../app4.rst:166 e5bf729d9fee46b2b7284fa3ed6c9099 +msgid "" +"How fast is a :title:`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 ":title:`PDF` ファイルの読み取りおよびそのコンテンツの解析は、どれだけ高速に行われるのでしょうか？純粋な解析の性能を直接比較することはできません。なぜなら、バッチユーティリティは常に要求されたタスクを一度に完全に実行するからです。 :title:`PDFrw` も解析の際には *レイジー* な戦略を採用しており、必要な瞬間に必要な部分のみを解析します。" + +#: ../../app4.rst:168 7bdb36f76ef448318f5fc00751deb7c1 +msgid "" +"To find an answer to the question, we therefore measure the time to copy " +"a :title:`PDF` file to an output file with each tool, and do nothing " +"else." +msgstr "したがって、この質問に答えるために、各ツールで :title:`PDF` ファイルを出力ファイルにコピーする時間を計測し、それ以外の操作は行いません。" + +#: ../../app4.rst:170 ../../app4.rst:365 5ab34b74cd604749be3379e5229732d1 +#: 915b5d39fb6b4735a7ceec825a4f73ee +msgid "These are the :title:`Python` commands for how each tool is used:" +msgstr "各ツールの使用方法に関する :title:`Python` コマンドは以下の通りです：" + +#: ../../app4.rst:180 e28220c005484d3288f9a579523d6065 +msgid ":title:`PDFrw`" +msgstr "" + +#: ../../app4.rst:190 56fb9e24ed274b6d8acbf0edbf1719c6 +msgid ":title:`PikePDF`" +msgstr "" + +#: ../../app4.rst:198 95be39f3e4e04c1f99f62dc3832386de +msgid ":title:`PyPDF2`" +msgstr "" + +#: ../../app4.rst:210 ../../app4.rst:288 ../../app4.rst:399 +#: 15166afa26b442c782b604f3107b0ad3 6207ea1347c04ea68afac2437dfa705b +#: 7ee61cbfb0ef46f7a30182469d1a5213 +msgid "**Observations**" +msgstr "**観察結果**" + +#: ../../app4.rst:212 ../../app4.rst:290 ../../app4.rst:401 +#: 974b59b72d354f74a8528e756775031a cc3f56dedbde45e69a0033a48fdba23e +#: f4d6a2855f0b435aac425eb0b5bae4ce +msgid "" +"These are our run time findings in **seconds** along with a base rate " +"summary compared to :title:`PyMuPDF`:" +msgstr "以下は、実行時間の結果（ **秒単位**）と、 :title:`PyMuPDF` との比較における基本レートの要約です：" + +#: ../../app4.rst:218 ../../app4.rst:296 ../../app4.rst:408 +#: 9df03a667e904b9e8792fb6d7a13512d aeceaf75f8d24722a0603ac5f3e41bf6 +#: dbd7d8ba012d45ce8a6716d4f19336de +msgid "**PyMuPDF**" +msgstr "" + +#: ../../app4.rst:219 d8d2aa36870e4ef0947eb2e7ca0e251d +msgid "**PDFrw**" +msgstr "" + +#: ../../app4.rst:220 b302281b6d6d4271be163094d34cd2f7 +msgid "**PikePDF**" +msgstr "" + +#: ../../app4.rst:221 ../../app4.rst:298 168de44e6f544f34820f9b4901463055 +#: cf3bc89e3d1b4f6b8836f046b1652e99 +msgid "**PyPDF2**" +msgstr "" + +#: ../../app4.rst:222 ../../app4.rst:300 ../../app4.rst:411 +#: 692b3b08f5834e54a9dcdb47a55706fe 73f084f8a5af4dfeb581d985acc8567b +#: cdf4a04f4b4a463d9541640a9c49f069 +msgid "adobe.pdf" +msgstr "" + +#: ../../app4.rst:223 ea613374b423460286ed33cbb413f31f +msgid "1.75" +msgstr "" + +#: ../../app4.rst:224 dcc9350bfdf343f38b383de903302849 +msgid "5.15" +msgstr "" + +#: ../../app4.rst:225 611db1502bb14ba89923d8be627fc87c +msgid "22.37" +msgstr "" + +#: ../../app4.rst:226 d0c52d5cce30462785c438994eb74b21 +msgid "374.05" +msgstr "" + +#: ../../app4.rst:227 ../../app4.rst:305 ../../app4.rst:415 +#: 3b4d0332272e43478db075b50fa00489 deee43e76b6c48e799974db35b8e11ac +#: e555a527b2fe4bd891aeadaf49cca198 +msgid "artifex-website.pdf" +msgstr "" + +#: ../../app4.rst:228 4c432ec2898e4252bee5ff77b5e3ca0b +msgid "0.26" +msgstr "" + +#: ../../app4.rst:229 ../../app4.rst:243 3031e2b02b214b9383f737a6ab08135d +#: 7f6593cf3c6845cb956e8ac3e8648b21 +msgid "0.38" +msgstr "" + +#: ../../app4.rst:230 97df865d382c4611ac42f74be40dc6cb +msgid "1.41" +msgstr "" + +#: ../../app4.rst:231 d8a4e5b3c39c4d3689d7613ce39fe690 +msgid "2.81" +msgstr "" + +#: ../../app4.rst:232 ../../app4.rst:310 ../../app4.rst:419 +#: a72bb9acb4734dc9af3094a42b60fddf af40770987af45579bb14d82a2165278 +#: fb8e2ae89de74d8e9ffc2072ab7ea2be +msgid "db-systems.pdf" +msgstr "" + +#: ../../app4.rst:233 cc499b9dcf274943b6ff6efd717b848b +msgid "0.15" +msgstr "" + +#: ../../app4.rst:234 5ac4b91364b24700a48507f7605b3792 +msgid "0.8" +msgstr "" + +#: ../../app4.rst:235 bed4c28888c946018416c00d16d75550 +msgid "1.68" +msgstr "" + +#: ../../app4.rst:236 332a419a20e742afbd1b1efdd7f719f8 +msgid "2.46" +msgstr "" + +#: ../../app4.rst:237 ../../app4.rst:315 ../../app4.rst:423 +#: 3678431052d049749225b2fe3ce6367a 43a99212e93249a78f525662b144cbb2 +#: 874f3f96d563442ebc057cb332d43784 +msgid "fontforge.pdf" +msgstr "" + +#: ../../app4.rst:238 f5a333915193415fa0c21a1e8a6f6b92 +msgid "0.09" +msgstr "" + +#: ../../app4.rst:239 c8f56a41c0a54bf79c9e9f1265b95b1a +msgid "0.14" +msgstr "" + +#: ../../app4.rst:240 644883982d6848d78024d481500ea360 +msgid "0.28" +msgstr "" + +#: ../../app4.rst:241 ../../app4.rst:308 4c5ba38976d1497b81d722c2087d2fd4 +#: 799d2851fbcd4f78b0a5320606255ac8 +msgid "1.1" +msgstr "" + +#: ../../app4.rst:242 ../../app4.rst:320 ../../app4.rst:427 +#: 661832415f114e919a931cba55614aed 6ab010e326a0461382002498ad51f190 +#: d3bd270fbcd945648f67919019e840f8 +msgid "pandas.pdf" +msgstr "" + +#: ../../app4.rst:244 93a4d469c88645d68c3d1fbd4e472129 +msgid "2.21" +msgstr "" + +#: ../../app4.rst:245 00bdf777a816455e9c3ad38c8ac3f0da +msgid "2.73" +msgstr "" + +#: ../../app4.rst:246 528874b37e9b4d328d61d15b6e9ac29b +msgid "70.3" +msgstr "" + +#: ../../app4.rst:247 ../../app4.rst:325 ../../app4.rst:431 +#: 9efd9fccb79a4cb2b48707996b9c8ec2 bbe7f9df346a470fbf9c17124eabb00d +#: e8d1663e67e849b5901c3dab91f2b52f +msgid "pymupdf.pdf" +msgstr "" + +#: ../../app4.rst:248 c7c0bdcc2bff429393624e04ce61a730 +msgid "0.11" +msgstr "" + +#: ../../app4.rst:249 4d971c369b6843dfbacb57e495f5b419 +msgid "0.56" +msgstr "" + +#: ../../app4.rst:250 8b8a26ee24a04be9adfcfae2dc517e25 +msgid "0.83" +msgstr "" + +#: ../../app4.rst:251 b10bbef58e2a4622b54cc6dd4be533d0 +msgid "6.05" +msgstr "" + +#: ../../app4.rst:252 ../../app4.rst:330 ../../app4.rst:435 +#: 323f47fc2f1d44a085d2d1e84abee8a5 6a700503996e45d7ad1a278f7b4d6e2d +#: eb4106100a6d48fdb398f129c4d1888d +msgid "pythonbook.pdf" +msgstr "" + +#: ../../app4.rst:253 96c45c5694e549feb5a57422c70ab2ff +msgid "0.19" +msgstr "" + +#: ../../app4.rst:254 9bc397fda5ab41db966afef26f4ca840 +msgid "1.2" +msgstr "" + +#: ../../app4.rst:255 186949f116144c9f92c62af5606eb9a0 +msgid "1.34" +msgstr "" + +#: ../../app4.rst:256 c480e636a915485998bdd4ff05ed1e8c +msgid "37.19" +msgstr "" + +#: ../../app4.rst:257 ../../app4.rst:335 ../../app4.rst:439 +#: 3767e3547c404558b9ea54e1636aa38a 9fd75b69ad914726b4e0fc2eb87bd930 +#: b0c5ee27a1564fcc9bacde3f84f01604 +msgid "sample-50-MB-pdf-file.pdf" +msgstr "" + +#: ../../app4.rst:258 3ac80bfe06a6466b807178b9cd940b3f +msgid "0.12" +msgstr "" + +#: ../../app4.rst:259 74cff96c735042dc979655e89b6cd7c1 +msgid "0.1" +msgstr "" + +#: ../../app4.rst:260 e2dd5a96337e427b84de42cd93c3e35e +msgid "2.93" +msgstr "" + +#: ../../app4.rst:261 a65a648402224ebdb56f72cd09e95dc9 +msgid "0.08" +msgstr "" + +#: ../../app4.rst:262 ../../app4.rst:340 ../../app4.rst:443 +#: 16934e5745fa4e70b36f6778ff2140c1 7896cf3923894dbbbc6ca6563f7debdf +#: b1a0bddf2ff34ec7ab1e7940e6cde15d +msgid "**Total**" +msgstr "**合計** " + +#: ../../app4.rst:263 28cf40a46da2482a93c201906fb039c3 +msgid "**3.05**" +msgstr "" + +#: ../../app4.rst:264 dddd21ea2e5e4182b875dd9ed6da6efb +msgid "**10.54**" +msgstr "" + +#: ../../app4.rst:265 0fc439df2934427480ae9d2e2274e23e +msgid "**33.57**" +msgstr "" + +#: ../../app4.rst:266 4d6a1667feba4cbc817636c39fbcb3d5 +msgid "**494.04**" +msgstr "" + +#: ../../app4.rst:272 ../../app4.rst:350 ../../app4.rst:451 +#: 90a4a88a385e434486d1b04c50fc64f4 c548d757925b4695a51eeb95cc2e1673 +#: f24afb98730547468876cfecb11bc709 +msgid "**Rate compared to PyMuPDF**" +msgstr "**PyMuPDFに対する比率** " + +#: ../../app4.rst:273 ../../app4.rst:351 ../../app4.rst:452 +#: 849d746c5eab4b5db97d520f6b9939a0 e0f0342c5dd84540af2dd45dae62947a +#: e4ba085886b84b85811ce6804521d9f4 +msgid ":green-color:`1.0`" +msgstr "" + +#: ../../app4.rst:274 ff773716620146f5911ae04e744067ad +msgid ":orange-color:`3.5`" +msgstr "" + +#: ../../app4.rst:275 0f695b1aa4ec4cc3a128156a3c78d442 +msgid ":orange-color:`11.0`" +msgstr "" + +#: ../../app4.rst:276 cb9ff2dca34246e1b87259c056eb2bb0 +msgid ":red-color:`162`" +msgstr "" + +#: ../../app4.rst:283 63c01914b71541de9227dfb9637ea9ff +msgid "Text Extraction" +msgstr "テキスト抽出" + +#: ../../app4.rst:285 c166066c1aa64e3384a5c283822ea6c5 +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 11f0b736fae14807968b6fddc1ad057a +#: 52c20be5534141fba2a1fcc6dfb2b2a3 +msgid "**XPDF**" +msgstr "" + +#: ../../app4.rst:299 42cc16177ba945138f4eae24116cb76d +msgid "**PDFMiner**" +msgstr "" + +#: ../../app4.rst:301 1606cdf993e64701a5c088ac9df98678 +msgid "2.01" +msgstr "" + +#: ../../app4.rst:302 9be766d4f713462eb315d58215d13fe7 +msgid "6.19" +msgstr "" + +#: ../../app4.rst:303 2318b8677831455a8aaa4b7763a9cb00 +msgid "22.2" +msgstr "" + +#: ../../app4.rst:304 83c635dce0bf423c9a93893c0e699050 +msgid "49.15" +msgstr "" + +#: ../../app4.rst:306 fe89c1c8e64441cd80ad39d23458a153 +msgid "0.18" +msgstr "" + +#: ../../app4.rst:307 c566039691a34402970bb2074c8373c7 +msgid "0.3" +msgstr "" + +#: ../../app4.rst:309 e84428585ed64f22b8f85a556ba101a6 +msgid "4.06" +msgstr "" + +#: ../../app4.rst:311 48004419cab4408590f6fd4a9ca0247c +msgid "1.57" +msgstr "" + +#: ../../app4.rst:312 74898de52754482290536758bb36c479 +msgid "4.26" +msgstr "" + +#: ../../app4.rst:313 4c7d6bdedf704b28aa69a16407cc800e +msgid "25.75" +msgstr "" + +#: ../../app4.rst:314 df46269ec4ef462891051e2b59670591 +msgid "42.19" +msgstr "" + +#: ../../app4.rst:316 86c83c5dbffb462b9219a11c6d352d25 +msgid "0.24" +msgstr "" + +#: ../../app4.rst:317 6b893558ff31413aa0de5ffe115b4c0e +msgid "0.47" +msgstr "" + +#: ../../app4.rst:318 08994c6a52d04825b9a40df993915bb1 +msgid "2.69" +msgstr "" + +#: ../../app4.rst:319 6373d0f539e14347b5e72be1341dab77 +msgid "4.2" +msgstr "" + +#: ../../app4.rst:321 50908e4aa7194c25a5c1b85b65ac378a +msgid "2.41" +msgstr "" + +#: ../../app4.rst:322 b189d97eb14541a6962f551a4879504c +msgid "10.54" +msgstr "" + +#: ../../app4.rst:323 a4ea2ed658ee412d93b27d5bb7060d9c +msgid "25.38" +msgstr "" + +#: ../../app4.rst:324 444ea285e3874242bb0c99487b2d6440 +msgid "76.56" +msgstr "" + +#: ../../app4.rst:326 5a9516664ccc437492552c523b59c4c6 +msgid "0.49" +msgstr "" + +#: ../../app4.rst:327 e46a2dc6aca84f5eab982041c8a8c915 +msgid "2.34" +msgstr "" + +#: ../../app4.rst:328 cab65185ff6e4f71b9d28b45b1650d72 +msgid "6.44" +msgstr "" + +#: ../../app4.rst:329 71d3cfc4bfbd4d8a97f4f90d7834631f +msgid "13.55" +msgstr "" + +#: ../../app4.rst:331 fc5ab74f778847aab4bad2c7a786ba92 +msgid "0.84" +msgstr "" + +#: ../../app4.rst:332 f8e78c84788149dea103259fe2b2c011 +msgid "2.88" +msgstr "" + +#: ../../app4.rst:333 5864281c5bda4fad98f52466c3d4bdbf +msgid "9.28" +msgstr "" + +#: ../../app4.rst:334 2901dc7bdb8640aeb04c87f8053c4da3 +msgid "24.27" +msgstr "" + +#: ../../app4.rst:336 ca65d65c11944eb1aaf5a2fb73d7acd1 +msgid "0.27" +msgstr "" + +#: ../../app4.rst:337 ac10c8c961b64bddb9021a453d566717 +msgid "0.44" +msgstr "" + +#: ../../app4.rst:338 e9d7c3e1d6764cc8bf84b214408ef52e +msgid "8.8" +msgstr "" + +#: ../../app4.rst:339 219ef87b5acf4189afc90cce4114e525 +msgid "13.29" +msgstr "" + +#: ../../app4.rst:341 3f88fd39b07d4f7c804b1529f8926698 +msgid "**8.01**" +msgstr "" + +#: ../../app4.rst:342 18441994bd4940d18fa0db52babf6906 +msgid "**27.42**" +msgstr "" + +#: ../../app4.rst:343 76a55e750b884a46890197d95541c97b +msgid "**101.64**" +msgstr "" + +#: ../../app4.rst:344 03ae808f9f744353ae775352ad57b10f +msgid "**227.27**" +msgstr "" + +#: ../../app4.rst:352 b388a44f67c24a52be7cf1dd9b90b3ed +msgid ":orange-color:`3.42`" +msgstr "" + +#: ../../app4.rst:353 3ab55e7e21034e97b94e0c096bc52aa1 +msgid ":orange-color:`12.69`" +msgstr "" + +#: ../../app4.rst:354 7c344dce997b4c7f990bfc9a421b32aa +msgid ":red-color:`28.37`" +msgstr "" + +#: ../../app4.rst:360 f772e8b1da3e42308e26ed1ae4d58fc1 +msgid "Page Rendering" +msgstr "ページのレンダリング" + +#: ../../app4.rst:362 ead0738e1b934defaf09c5be6916daa3 +msgid "" +"We have tested rendering speed of :title:`PyMuPDF` against " +":title:`pdf2jpg` and :title:`XPDF` at a resolution of 150 DPI," +msgstr "私たちは、解像度150 DPIで :title:`PyMuPDF` のレンダリング速度を :title:`pdf2jpg` と :title:`XPDF` と比較しました。" + +#: ../../app4.rst:382 1fab69d0e2af48f0a9f0f3fa30f0c6f6 +msgid ":title:`XPDF`" +msgstr "" + +#: ../../app4.rst:389 d6ba27839bf64c488bf74bb2e1e57873 +msgid ":title:`PDF2JPG`" +msgstr "" + +#: ../../app4.rst:410 63ce81487bb34ec89ba0c1f0a348d4a9 +msgid "**PDF2JPG**" +msgstr "" + +#: ../../app4.rst:412 88b8f3078fa44a61b579e057515acd1c +msgid "51.33" +msgstr "" + +#: ../../app4.rst:413 bbe8931f115d42aca182e9407578a02f +msgid "98.16" +msgstr "" + +#: ../../app4.rst:414 7262738febdb4753ba11f2fb25322f17 +msgid "75.71" +msgstr "" + +#: ../../app4.rst:416 8c5d5fc5843b4b33a05f70c828c56dfe +msgid "26.35" +msgstr "" + +#: ../../app4.rst:417 cf469bfdd66a41f6a0440423d5ee75fa +msgid "51.28" +msgstr "" + +#: ../../app4.rst:418 5d8ea9fabdc145a58a979ac291201164 +msgid "54.11" +msgstr "" + +#: ../../app4.rst:420 1fbc73aa1ca2426e876e7672aa365686 +msgid "84.59" +msgstr "" + +#: ../../app4.rst:421 ea251e62a044421ca983016f8950dd87 +msgid "143.16" +msgstr "" + +#: ../../app4.rst:422 35609e6523b44c7c974e4745cea5d667 +msgid "405.22" +msgstr "" + +#: ../../app4.rst:424 a05f863e08c547c880f00be43a3542c0 +msgid "12.23" +msgstr "" + +#: ../../app4.rst:425 42daac4998bc44e4aac09a86b5a3c55a +msgid "22.18" +msgstr "" + +#: ../../app4.rst:426 8681927f26864fd39ea7c201346e6afb +msgid "20.14" +msgstr "" + +#: ../../app4.rst:428 e04b91bd2126421fa54a16dea942dee3 +msgid "138.74" +msgstr "" + +#: ../../app4.rst:429 b31a50d7fa58484b9f35a172bdf0dff7 +msgid "241.67" +msgstr "" + +#: ../../app4.rst:430 b0efc770265c45d49849dbf092d2e20a +msgid "202.06" +msgstr "" + +#: ../../app4.rst:432 7d620df0ada4436fb937c240246d0927 +msgid "22.35" +msgstr "" + +#: ../../app4.rst:433 d9c922c17ab2463093d8f600ca013caa +msgid "39.11" +msgstr "" + +#: ../../app4.rst:434 7377dbefa11042f8b91ef5490aa53cc1 +msgid "33.38" +msgstr "" + +#: ../../app4.rst:436 83037ee81f1f4c02b0c84c8eb231f694 +msgid "30.44" +msgstr "" + +#: ../../app4.rst:437 aa5a6bb5fa834cee9c1bcb4c671eab3f +msgid "49.12" +msgstr "" + +#: ../../app4.rst:438 720afcbe1cb64ca48233a3f55bd0d808 +msgid "55.68" +msgstr "" + +#: ../../app4.rst:440 b47cd78a58e84745a0f1d70724a5f560 +msgid "1.01" +msgstr "" + +#: ../../app4.rst:441 5fea368f2827433f8fa6b64c6c41c9af +msgid "1.32" +msgstr "" + +#: ../../app4.rst:442 535d22b214e945de8fbdf630bbda80f8 +msgid "5.22" +msgstr "" + +#: ../../app4.rst:444 6bac36a76eec4adba37fc9e450398b34 +msgid "**367.04**" +msgstr "" + +#: ../../app4.rst:445 4bfa1c6c075f49d4a24da40d054b20f8 +msgid "**646**" +msgstr "" + +#: ../../app4.rst:446 dee1cae954064c8a8603955888904edb +msgid "**851.52**" +msgstr "" + +#: ../../app4.rst:453 be65ac3fb8b54e1caf7b12890f593d42 +msgid ":orange-color:`1.76`" +msgstr "" + +#: ../../app4.rst:454 a9c4728bc957426cbbc4827152aec2ff +msgid ":red-color:`2.32`" +msgstr "" + +#: ../../footer.rst:-1 29a3d891d6c64114acc2690074ccd35f +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/archive-class.mo b/docs/locales/ja/LC_MESSAGES/archive-class.mo new file mode 100644 index 000000000..7447a1a13 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/archive-class.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/archive-class.po b/docs/locales/ja/LC_MESSAGES/archive-class.po new file mode 100644 index 000000000..dccac8f11 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/archive-class.po @@ -0,0 +1,251 @@ +# 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" + +#: ../../archive-class.rst:7 cbddf81d2a68467c9f24fa33fc7f96ad +msgid "Archive" +msgstr "Archive (アーカイブ)" + +#: ../../archive-class.rst:9 1360c74e68f247a19a9bd9537ee36ac7 +msgid "New in v1.21.0" +msgstr "v1.21.0での新機能" + +#: ../../archive-class.rst:11 84721349647b43ffb95d35c5e15fce71 +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 19fa20e5cb404f6cbf4fc876d84bf01b +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 5ab448cf36bd4b0c8a2ee911b0fbf350 +msgid "**Method / Attribute**" +msgstr "**メソッド / 属性**" + +#: ../../archive-class.rst:16 ea2f425c9aa649ad9883b7f23e5615b7 +msgid "**Short Description**" +msgstr "**簡単な説明**" + +#: ../../archive-class.rst:18 039b1a9cf75e49ad9007430fe2f0c1e9 +msgid ":meth:`Archive.add`" +msgstr "" + +#: ../../archive-class.rst:18 fc94218186184ac38d171cbf42ca6f1d +msgid "add new data to the archive" +msgstr "アーカイブに新しいデータを追加する" + +#: ../../archive-class.rst:19 8b30aa94bb7d4e5188a61ca6530f02ea +msgid ":meth:`Archive.has_entry`" +msgstr "" + +#: ../../archive-class.rst:19 58cece5b265449ebbb21d9a1350aa6e8 +msgid "check if given name is a member" +msgstr "名前で指定されたデータを読む" + +#: ../../archive-class.rst:20 e62621b2b41642f394e44c0f0f5ea744 +msgid ":meth:`Archive.read_entry`" +msgstr "" + +#: ../../archive-class.rst:20 425cfb846f6d49c0b5c2e110373f67d0 +msgid "read the data given by the name" +msgstr "名前で指定されたデータを読む" + +#: ../../archive-class.rst:21 65c0b741a8c2401c8984d63306e262a9 +msgid ":attr:`Archive.entry_list`" +msgstr "" + +#: ../../archive-class.rst:21 591798a00fe541b98e584adf3f49e75e +msgid "list[dict] of archive items" +msgstr "アーカイブアイテムのリスト[辞書]" + +#: ../../archive-class.rst:24 9bbcc21ebd34406b91f333d9db07a398 +msgid "**Class API**" +msgstr "クラス API" + +#: ../../archive-class.rst:30 effdcb484b13440485cad2942946afb4 +msgid "Creates a new archive. Without parameters, an empty archive is created." +msgstr "新しいアーカイブを作成します。パラメーターが指定されない場合、空のアーカイブが作成されます。" + +#: ../../archive-class.rst:32 449ce11e9fe845fea99e2b97cdf4eff7 +msgid "If provided, `content` may be one of the following:" +msgstr "提供される場合、`content` は次のいずれかであることができます：" + +#: ../../archive-class.rst:34 d2f010dae5844c47890eef108b196ba9 +msgid "another Archive: the archive is being made a sub-archive of the new one." +msgstr "別の Archive: アーカイブは新しいアーカイブのサブアーカイブになります。" + +#: ../../archive-class.rst:36 6bdcf4b959fd4af3aff88f48962e9370 +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 8ff1e77a1f84458391c25b21199306df +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 27be509bcbc74940ae9b4f73e6ec3ad1 +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 5ce5cfbe5cbe4e31b161f168211c985f +msgid "" +"a `zipfile.ZipFile` or `tarfile.TarFile` object: Will be added as a sub-" +"archive." +msgstr "`zipfile.ZipFile` または `tarfile.TarFile` オブジェクト: サブアーカイブとして追加されます。" + +#: ../../archive-class.rst:43 d2700d78b1da4d54a7019cf9252241ec +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 95b7f1e96d5f413e8e49456446361b00 +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 d26163dca8394cbfb4ccf069a146a983 +msgid "" +"a Python sequence: This is a convenience format to specify any " +"combination of the above." +msgstr "Pythonシーケンス: これは上記のいずれかの組み合わせを指定するための便益フォーマットです。" + +#: ../../archive-class.rst:49 b97db892b83d4efd89e5dd888d926c4c +msgid "If provided, `path` must be a string." +msgstr "提供される場合、`path` は文字列である必要があります。" + +#: ../../archive-class.rst:51 2db5e320695140bc9097164d568962da +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 a12ddc3a6051490cb489464b4c232d6e +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 680ced06c4234d90919f2af02cbeb200 +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 000ca11e97d64cce9b76672f1089f0d4 +msgid "" +"Append a sub-archive. The meaning of the parameters are exactly the same " +"as explained above. Of course, parametrer `content` is not optional here." +msgstr "サブアーカイブを追加します。パラメータの意味は上記とまったく同じです。もちろん、ここではパラメータ `content` はオプションではありません。" + +#: ../../archive-class.rst:63 0dd9037712ed4421bbf87015619ec9b2 +msgid "Checks whether an entry exists in any of the sub-archives." +msgstr "エントリがサブアーカイブのいずれかに存在するかどうかを確認します。" + +#: ../../archive-class.rst 2042529d67a1461e86e1432c23096718 +#: c7c3e7ca8a0f4bcab55b3a691d3dd712 +msgid "Parameters" +msgstr "パラメータ:" + +#: ../../archive-class.rst:65 ../../archive-class.rst:73 +#: ec1c358b15624e1fabbc01e42e751f86 fbd85286583346e18e275454aa0506c9 +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 5112b69db55348e9a8df4521c3e93c26 +#: a8caf3f8348448f59cc1eb8640f3c8f6 +msgid "Returns" +msgstr "戻り値:" + +#: ../../archive-class.rst:67 d117071695824e698bb8cd4ed453aa6b +msgid "`True` or `False`." +msgstr "`True` または `False` 。" + +#: ../../archive-class.rst:71 5c04eff105834dfa9b4e1b7e1ee57217 +msgid "Retrieve the data of an entry." +msgstr "エントリのデータを取得します。" + +#: ../../archive-class.rst:75 ee6b5e9987de418cbd411c14b502432b +msgid "" +"The binary data (`bytes`) of the entry. If not found, an exception is " +"raised." +msgstr "エントリのバイナリデータ（ `bytes` ）です。見つからない場合は例外が発生します。" + +#: ../../archive-class.rst:79 f66b696037904b8992cb50f61da48fb6 +msgid "" +"A list of the archive's sub-archives. Each list item is a dictionary with" +" the following keys:" +msgstr "アーカイブのサブアーカイブのリストです。各リストアイテムは、次のキーを持つ辞書です：" + +#: ../../archive-class.rst:81 e3aa41a45b9646e98254df3ac1658724 +msgid "`entries` -- a list of (top-level) entry names in this sub-archive." +msgstr "`entries` - このサブアーカイブ内の（トップレベルの）エントリ名のリスト。" + +#: ../../archive-class.rst:82 73c9c0eeb8344c879fdf68866f11dcd9 +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 510e1f3287724e1b9de9b63e5a25e6e4 +msgid "" +"`path` -- the value of the `path` parameter under which this sub-archive " +"was added." +msgstr "`path` - このサブアーカイブが追加されたパラメータの値です。" + +#: ../../archive-class.rst:85 07a4ab4f529343c596de2956c02c737e +msgid "**Example:**" +msgstr "**例：** " + +#: ../../footer.rst:-1 241ac14b2858481f8d14ca5b22d037bf +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/changes.mo b/docs/locales/ja/LC_MESSAGES/changes.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/changes.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/changes.po b/docs/locales/ja/LC_MESSAGES/changes.po new file mode 100644 index 000000000..0a787bfdc --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/changes.po @@ -0,0 +1,5842 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../../changes.txt:2 592961a7cf6a4ec5bf08cdd9dce84347 +msgid "Change Log" +msgstr "" + +#: ../../../changes.txt:5 6556779d038f45f3b30ecd15c881988d +msgid "**Changes in version 1.23.0rc1 (2023-08-10)**" +msgstr "" + +#: ../../../changes.txt:7 ac701a8c063348e986a53e38e0b9391a +msgid "Contains a new \"rebased\" implementation of PyMuPDF." +msgstr "" + +#: ../../../changes.txt:9 8dac474c22944cbead8cd6af54fa07ef +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:14 27214a0d010643a7b558fb0efd30c35d +msgid "" +"Python-independent MuPDF libraries are now in a second wheel called " +"`PyMuPDFb` that will be automatically installed by pip." +msgstr "" + +#: ../../../changes.txt:17 262cc5c25c9a4af495e9ca780a4bc503 +msgid "" +"This is to save space on pypi.org - a full release only needs one " +"`PyMuPDFb` wheel for each OS." +msgstr "" + +#: ../../../changes.txt:20 ../../../changes.txt:96 ../../../changes.txt:128 +#: ../../../changes.txt:137 ../../../changes.txt:146 ../../../changes.txt:164 +#: ../../../changes.txt:264 ../../../changes.txt:303 +#: 77ae426aa6b34fc38d01a560702727fa 7d462fa28fb34276b598ff446fc874c0 +#: 7e4c236eca63428ea008183a5592a8e1 7fcaadf83f33466888da76834810a5b3 +#: 8c73bc5310c94de3917282e8401eafeb 965474e930c44c6ba0ab68efc60c5a47 +#: c1aebfa10f944764b9dab8602a407555 e2c8d96bb4f14da6a96cb081b1da324c +msgid "Bug fixes:" +msgstr "" + +#: ../../../changes.txt:22 1ad66982396f483396bca8b04cf67eaa +msgid "" +"**Fixed** `#2542 `_: " +"fritz.utils.scrub AttributeError Annot object has no attribute fileUpd " +"inside" +msgstr "" + +#: ../../../changes.txt:23 06b26fe40f2e40b3814f6194c903036e +msgid "" +"**Fixed** `#2533 `_: " +"get_texttrace returned a incorrect character bbox" +msgstr "" + +#: ../../../changes.txt:24 0a22e16bf5754ed48973931411e14447 +msgid "" +"**Fixed** `#2537 `_: " +"Validation when setting a grouped RadioButton throws a RuntimeError: path" +" to 'V' has indirects" +msgstr "" + +#: ../../../changes.txt:26 ../../../changes.txt:824 ../../../changes.txt:988 +#: 14f6fc59d7cf443e86324e0180ba44b0 86519eb955464a959477640b76038fc4 +#: 9c4bd181bd48422aa8dc2837ed32107b +msgid "Other changes:" +msgstr "" + +#: ../../../changes.txt:28 a46a42f5e1dd422ab38d584575361136 +msgid "Dropped support for Python-3.7." +msgstr "" + +#: ../../../changes.txt:30 4d1c83f4403240229e7e11b1bb290ad6 +msgid "Fix for wrong page / annot `/Contents` cleaning." +msgstr "" + +#: ../../../changes.txt:32 68772f4feaef448d86ee5da1070ca850 +msgid "We need to set `pdf_filter_options::no_update` to zero." +msgstr "" + +#: ../../../changes.txt:34 8e59ca002ffb4b958d27f39b63eed870 +msgid "Added new function get_tessdata()." +msgstr "" + +#: ../../../changes.txt:36 3b684eee1570458596ee558ba2893c5f +msgid "Cope with problem `/Annot` arrays." +msgstr "" + +#: ../../../changes.txt:38 493ee26562424d0387b5cf1a36df35a3 +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:44 7fc1402a66644147aa9da81c2f33963c +msgid "Additional annotation type checks." +msgstr "" + +#: ../../../changes.txt:46 6695c904a56b4d769d816fa9abe081ad +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:50 855a9da4fa0349e2b7af4011abe7cb28 +msgid "Increase fault tolerance." +msgstr "" + +#: ../../../changes.txt:52 225068f58f684676b526c64cd0521d82 +msgid "" +"Avoid exceptions in method `insert_pdf()` when source pages contains " +"invalid items in the `/Annots` array." +msgstr "" + +#: ../../../changes.txt:55 6a174a5ca0f7418c8e39a61278af5f3d +msgid "Return empty border dict for applicable annots." +msgstr "" + +#: ../../../changes.txt:57 c0103f2dce704857a1b61ff192db5e2f +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:62 f9a4281d9c8e43889495e8bd3b9bd930 +msgid "Restrict `set_rect` to applicable annot types." +msgstr "" + +#: ../../../changes.txt:64 339930ed19fe48a086ea499b523cf3ad +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:68 9c0e93bd2a29493dbe349474ec85a808 +msgid "Wrong fontsize computation in `page.get_texttrace()`." +msgstr "" + +#: ../../../changes.txt:70 8c08394cdeeb43fa98ba4f7ebf9963c5 +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:74 58178b9c61734911a0ffa5206d8b2615 +msgid "Updates to cope with changes to latest MuPDF." +msgstr "" + +#: ../../../changes.txt:76 0ef100fbd1e34018a268c202ceac60d0 +msgid "`pdf_lookup_anchor()` has been removed." +msgstr "" + +#: ../../../changes.txt:78 11c91e3a17524dccbefa3e7b86d1f11b +msgid "Update fill_textbox to better respect rect.width" +msgstr "" + +#: ../../../changes.txt:80 d419504dce064e929bc86fa4251c2b98 +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:86 b674deb37a924acfa830d402238c8b11 +msgid "The fix was just to replace n+1 by n." +msgstr "" + +#: ../../../changes.txt:88 99aa94bb4fcf482689915b4c66456356 +msgid "Add `script_focus` and `script_blur` options to widget." +msgstr "" + +#: ../../../changes.txt:92 afb629be701a4aa0bfb938078a44ab7e +msgid "**Changes in version 1.22.5 (2023-06-21)**" +msgstr "" + +#: ../../../changes.txt:94 fbf8e817e76841358439abb1ca2282b0 +msgid "This release uses ``MuPDF-1.22.2``." +msgstr "" + +#: ../../../changes.txt:98 6e895292e40841d28af98baf164ad994 +msgid "" +"**Fixed** `#2365 `_: " +"Incorrect dictionary values for type \"fs\" drawings." +msgstr "" + +#: ../../../changes.txt:99 91fa87739054439c9c27bae87ba5e8f6 +msgid "" +"**Fixed** `#2391 `_: " +"Check box automatically uncheck when we update same checkbox more than 1 " +"times." +msgstr "" + +#: ../../../changes.txt:100 0941273ff9184d3b8b524c45486b4d84 +msgid "" +"**Fixed** `#2400 `_: Gaps" +" within text of same line not filled with spaces." +msgstr "" + +#: ../../../changes.txt:101 62197be88990477f87c07abac2daada4 +msgid "" +"**Fixed** `#2404 `_: " +"Blacklining an image in PDF won't remove underlying content in version " +"1.22.X." +msgstr "" + +#: ../../../changes.txt:102 8f72e3d7303c4b998f6715ca9738a1ad +msgid "" +"**Fixed** `#2430 `_: " +"Incorrectly reducing ref count of Py_None." +msgstr "" + +#: ../../../changes.txt:103 00413e6cd98b45a7b6e8d48d63ad01cf +msgid "" +"**Fixed** `#2450 `_: " +"Empty fill color and fill opacity for paths with fill and stroke " +"operations with 1.22.*" +msgstr "" + +#: ../../../changes.txt:104 2935b1b9c4f3465fa645e0dccfe16c12 +msgid "" +"**Fixed** `#2462 `_: " +"Error at \"get_drawing(extended=True )\"" +msgstr "" + +#: ../../../changes.txt:105 271c99d71dec465f9437f767c01828f3 +msgid "" +"**Fixed** `#2468 `_: " +"Decode error when trying to get drawings" +msgstr "" + +#: ../../../changes.txt:107 426281d4718a450ab37069a194a67b8d +msgid "New features:" +msgstr "" + +#: ../../../changes.txt:109 46bb44cb1baf470e9a2749dbe0de88a6 +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:113 3c75cc458a45497a99b5d0245a527b83 +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:116 482a7a83017e4b518ed8b414de98f783 +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:119 bd8aa9fe8dc1485ba56acded4b2db33c +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:124 d6b61140d3ed44d88ccb9a5e4d9670b0 +msgid "**Changes in version 1.22.3 (2023-05-10)**" +msgstr "" + +#: ../../../changes.txt:126 ../../../changes.txt:135 ../../../changes.txt:144 +#: ../../../changes.txt:156 50e7450640a14407a5e1c5b023988ded +#: 51c6c0fa60f9401895f0e15343a119ad 598a614eee184e52b69facee9a22fec4 +#: 708507107e4e4e8fa0949f336e4e3573 +msgid "This release uses ``MuPDF-1.22.0``." +msgstr "" + +#: ../../../changes.txt:130 77731d73c32c40d98eea0130f71e31cf +msgid "" +"**Fixed** `#2333 `_: " +"Unable to set any of button radio group in form" +msgstr "" + +#: ../../../changes.txt:133 3c1017c9146748348b4a6c3921874dbe +msgid "**Changes in version 1.22.2 (2023-04-26)**" +msgstr "" + +#: ../../../changes.txt:139 94917a44a4be4501bf41118950004190 +msgid "" +"**Fixed** `#2369 `_: " +"Image extraction bugs with newer versions" +msgstr "" + +#: ../../../changes.txt:142 4b68ee5f53af477b955118d5139b3d0e +msgid "**Changes in version 1.22.1 (2023-04-18)**" +msgstr "" + +#: ../../../changes.txt:148 d80f3b9ea6a042a1819fb8494f8af90c +msgid "" +"**Fixed** `#2345 `_: Turn" +" off print statements in utils.py" +msgstr "" + +#: ../../../changes.txt:149 2f67abae8c044527afe4aa64ec497d05 +msgid "" +"**Fixed** `#2348 `_: " +"extract_image returns an extension \"flate\" instead of \"png\"" +msgstr "" + +#: ../../../changes.txt:150 bad64aec1be5462aa28217a7f608fb4e +msgid "" +"**Fixed** `#2350 `_: Can " +"not make widget (checkbox) to read-only by adding flags " +"PDF_FIELD_IS_READ_ONLY" +msgstr "" + +#: ../../../changes.txt:151 4de3c89a9f0f4d2ba6efc40e6e1a2368 +msgid "" +"**Fixed** `#2355 `_: " +"1.22.0 error when using get_toc (AttributeError: 'SwigPyObject' object " +"has no attribute)" +msgstr "" + +#: ../../../changes.txt:154 774d142170fe4155bcfac238e1d8bdae +msgid "**Changes in version 1.22.0 (2023-04-14)**" +msgstr "" + +#: ../../../changes.txt:158 5601eccc6c874680853a48603364edec +msgid "Behavioural changes:" +msgstr "" + +#: ../../../changes.txt:160 81158208cf7d424b805aa47b74004818 +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:166 4731bcd4462f46aab58725066664b539 +msgid "" +"**Fixed** `#1763 `_: " +"Interactive(smartform) form PDF calculation not working in pymupdf" +msgstr "" + +#: ../../../changes.txt:167 84ecfb853b0a4ec0a779b54a1950ae55 +msgid "" +"**Fixed** `#1995 `_: " +"RuntimeError: image is too high for a long paged pdf file when trying" +msgstr "" + +#: ../../../changes.txt:168 a15cca89a2764e719ae529b79e452a58 +msgid "" +"**Fixed** `#2093 `_: " +"Image in pdf changes color after applying redactions" +msgstr "" + +#: ../../../changes.txt:169 af087b64312b4474a45e8d5e4a64f641 +msgid "" +"**Fixed** `#2108 `_: " +"Redaction removing more text than expected" +msgstr "" + +#: ../../../changes.txt:170 0419bf7456af4147ba953d9e5c7a1aab +msgid "" +"**Fixed** `#2141 `_: " +"Failed to read JPX header when trying to get blocks" +msgstr "" + +#: ../../../changes.txt:171 43d0e38c05df45f6b7dd8e5b1e998b58 +msgid "" +"**Fixed** `#2144 `_: " +"Replace image throws an error" +msgstr "" + +#: ../../../changes.txt:172 fecf6324fa5143b1a480fc6d2be02f38 +msgid "" +"**Fixed** `#2146 `_: " +"Wrong Handling of Reference Count of \"None\" Object" +msgstr "" + +#: ../../../changes.txt:173 2bfb5121b72d48d689cc09944d0d7201 +msgid "" +"**Fixed** `#2161 `_: " +"Support adding images as pages directly" +msgstr "" + +#: ../../../changes.txt:174 f7c65db3a9d242339c9ab323ac6d2629 +msgid "" +"**Fixed** `#2168 `_: " +"``page.add_highlight_annot(start=pointa, stop=pointb)`` not working" +msgstr "" + +#: ../../../changes.txt:175 b9cf5787cf984f36bced72ec83f08a7a +msgid "" +"**Fixed** `#2173 `_: " +"Double free of ``Colorspace`` used in ``Pixmap``" +msgstr "" + +#: ../../../changes.txt:176 f4ff1477138d408fbb381c3f71609475 +msgid "" +"**Fixed** `#2179 `_: " +"Incorrect documentation for ``pixmap.tint_with()``" +msgstr "" + +#: ../../../changes.txt:177 83f2da97b8664dfd85a51e2c6396c1af +msgid "" +"**Fixed** `#2208 `_: " +"Pushbutton widget appears as check box" +msgstr "" + +#: ../../../changes.txt:178 809ad5d7015a4454922061a1ba723284 +msgid "" +"**Fixed** `#2210 `_: " +"``apply_redactions()`` move pdf text to right after redaction" +msgstr "" + +#: ../../../changes.txt:179 72d3718cefc54ab2a2ddc10127eaa8ab +msgid "" +"**Fixed** `#2220 `_: " +"``Page.delete_image()`` | object has no attribute ``is_image``" +msgstr "" + +#: ../../../changes.txt:180 5c6cf09495c94fbd915298e08b6e2d53 +msgid "" +"**Fixed** `#2228 `_: open" +" some pdf cost too much time" +msgstr "" + +#: ../../../changes.txt:181 3d58b7db6bb0420eaa4ae0ca947a555a +msgid "" +"**Fixed** `#2238 `_: Bug " +"- can not extract data from file in the newest version 1.21.1" +msgstr "" + +#: ../../../changes.txt:182 5314531ad417443aac911af43577587d +msgid "" +"**Fixed** `#2242 `_: " +"Python quits silently in ``Story.element_positions()`` if callback " +"function prototype is wrong" +msgstr "" + +#: ../../../changes.txt:183 feeebb1b18374a938f68fc030f92507e +msgid "" +"**Fixed** `#2246 `_: " +"TextWriter write text in a wrong position" +msgstr "" + +#: ../../../changes.txt:184 29f92e29561d4db086ca0bec1e33fcca +msgid "" +"**Fixed** `#2248 `_: " +"After redacting the content, the position of the remaining text changes" +msgstr "" + +#: ../../../changes.txt:185 af2cf3079697483a831917469815162f +msgid "" +"**Fixed** `#2250 `_: " +"docs: unclear or broken link in page.rst" +msgstr "" + +#: ../../../changes.txt:186 2fe6a7580a3c4b3692d03e85814f446c +msgid "" +"**Fixed** `#2251 `_: " +"mupdf_display_errors does not apply to Pixmap when loading broken image" +msgstr "" + +#: ../../../changes.txt:187 d69c9519fcd64740a7413e2d3896cf4d +msgid "" +"**Fixed** `#2270 `_: " +"``Annot.get_text(\"words\")`` - doesn't return the first line of words" +msgstr "" + +#: ../../../changes.txt:188 4906b788fe7a4a58acbef752b56de257 +msgid "" +"**Fixed** `#2275 `_: " +"insert_image: document that rotations are counterclockwise" +msgstr "" + +#: ../../../changes.txt:189 9b0bf32e690841f6b554639f54c6aead +msgid "" +"**Fixed** `#2278 `_: Can " +"not make widget (checkbox) to read-only by adding flags " +"PDF_FIELD_IS_READ_ONLY" +msgstr "" + +#: ../../../changes.txt:190 5db5125994884c9e847e87851da116ba +msgid "" +"**Fixed** `#2290 `_: " +"Different image format/data from Page.get_text(\"dict\") and " +"Fitz.get_page_images()" +msgstr "" + +#: ../../../changes.txt:191 ad78fd71b0ec4d1a80dc3d2fcaf61ce3 +msgid "" +"**Fixed** `#2293 `_: 68 " +"failed tests when installing from sdist on my box" +msgstr "" + +#: ../../../changes.txt:192 b98abb98e15c4aceba2388aeb3de6399 +msgid "" +"**Fixed** `#2300 `_: Too " +"much recursion in tree (parents), makes program terminate" +msgstr "" + +#: ../../../changes.txt:193 154202f0e91f47d492f7ee7733602795 +msgid "" +"**Fixed** `#2322 `_: " +"add_highlight_annot using clip generates \"A Number is Out of Range\" " +"error in PDF" +msgstr "" + +#: ../../../changes.txt:195 ../../../changes.txt:329 +#: 4d358778c4704e19a5b2f3ca68509fcc e9042d87b1b940929e3d2b4b7ba697b4 +msgid "Other:" +msgstr "" + +#: ../../../changes.txt:197 6e1f739c1f1d4e36aca32f71f6516803 +msgid "" +"Add key \"/AS (Yes)\" to the underlying annot object of a selected button" +" form field." +msgstr "" + +#: ../../../changes.txt:199 15465ce09a2547c68de176f4f272546b +msgid "" +"Remove unused ``Document`` methods ``has_xref_streams()`` and " +"``has_old_style_xrefs()`` as MuPDF equivalents have been removed." +msgstr "" + +#: ../../../changes.txt:202 b8d078ed3bb2452cbb475fe37b600669 +msgid "" +"Add new ``Document`` methods and properties for getting/setting " +"``/PageMode``, ``/PageLayout`` and ``/MarkInfo``." +msgstr "" + +#: ../../../changes.txt:205 ab5d6980f3a9428283269d0ae3fc4c89 +msgid "" +"New ``Document`` property ``version_count``, which contains the number of" +" incremental saves plus one." +msgstr "" + +#: ../../../changes.txt:208 c4ad85f5c0274e089b7a59926372e3c1 +msgid "" +"New ``Document`` property ``is_fast_webaccess`` which tells whether the " +"document is linearized." +msgstr "" + +#: ../../../changes.txt:211 5a71cb2865c54af6a52aacfaf9d3c88d +msgid "``DocumentWriter`` is now a context manager." +msgstr "" + +#: ../../../changes.txt:213 14f8e1e291bd43bda8fb98d1dace77a1 +msgid "Add support for ``Pixmap`` JPEG output." +msgstr "" + +#: ../../../changes.txt:215 0d9a46f1d4a94a22a10024cbf8896323 +msgid "Add support for drawing rectangles with rounded corners." +msgstr "" + +#: ../../../changes.txt:217 758ecb91649c41a8bbe8e33fe7c278e9 +msgid "``get_drawings()``: added optional ``extended`` arg." +msgstr "" + +#: ../../../changes.txt:219 df42f516c52443118ddd12d1677420fc +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:223 dde9c38ad4e4443dbac6852deaf47bee +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:229 ../../../changes.txt:284 +#: 48dda47bbbd1417e8be5c69859a4bd4b 6cf1b773149748dd8a0c07370826de25 +msgid "Documentation:" +msgstr "" + +#: ../../../changes.txt:231 e862f61772dc40e0aa912b8a20145117 +msgid "General rework:" +msgstr "" + +#: ../../../changes.txt:233 193718fec05c4cbb84f9aa2fcdcdb713 +msgid "Introduces a new home page and new table of contents." +msgstr "" + +#: ../../../changes.txt:234 afbb27c9bc7a45f1ba21f92bbed5fd13 +msgid "Structural update to include new About section." +msgstr "" + +#: ../../../changes.txt:235 eb6ac431aa17419e98f92c32510acb21 +msgid "Comparison & performance graphing." +msgstr "" + +#: ../../../changes.txt:236 616df60e4dff4cf3b85962eb9716f782 +msgid "Includes performance methodology in appendix." +msgstr "" + +#: ../../../changes.txt:237 461d7c09a2e7411abb1775d689a15c59 +msgid "Updates conf.py to understand single back-ticks as code." +msgstr "" + +#: ../../../changes.txt:238 b0ede8abcc154a5fa8bccb422d79e9b1 +msgid "Converts double back-ticks to single back-ticks." +msgstr "" + +#: ../../../changes.txt:239 986ac18dff3f4c5b92fae407889e746d +msgid "Removes redundant files." +msgstr "" + +#: ../../../changes.txt:241 c2aea4eccfaa412c8fef1a656fc22428 +msgid "Improve ``insert_file()`` documentation." +msgstr "" + +#: ../../../changes.txt:243 80e903e3c84b402f83263ac5e81dd5c4 +msgid "``get_bboxlog()``: aded optional ``layers`` to ``get_bboxlog()``." +msgstr "" + +#: ../../../changes.txt:244 b5ff04de0ff74bd98c36432a815c6b2a +msgid "" +"``Page.get_texttrace()``: add new dictionary key ``layer``, name of " +"Optional Content Group." +msgstr "" + +#: ../../../changes.txt:246 ab1da44efcf443db834436a30d91ebc6 +msgid "Mention use of Python venv in installation documentation." +msgstr "" + +#: ../../../changes.txt:248 05ac4ae30e5b44ad9474ad2172204efc +msgid "Added missing fix for #2057 to release 1.21.1's changelog." +msgstr "" + +#: ../../../changes.txt:250 74503569478b41bebda07298d0bb7ff2 +msgid "Fixes many links to the PyMuPDF-Utilities repo scripts." +msgstr "" + +#: ../../../changes.txt:252 489f0648b931435dbff9b5613d3ed565 +msgid "Avoid duplication of ``changes.txt`` and ``docs/changes.rst``." +msgstr "" + +#: ../../../changes.txt:254 41f62a12efda43078c484aeeae540371 +msgid "Build" +msgstr "" + +#: ../../../changes.txt:256 ea75e60b5ce74c5e9310ee83aaadbd24 +msgid "Added ``pyproject.toml`` file to improve builds using pip etc." +msgstr "" + +#: ../../../changes.txt:260 be8b5e2cfa2b45d8b766fe3bfd238eeb +msgid "**Changes in Version 1.21.1 (2022-12-13)**" +msgstr "" + +#: ../../../changes.txt:262 0b5e3ef0e9984461a5471cffad33dc69 +msgid "This release uses ``MuPDF-1.21.1``." +msgstr "" + +#: ../../../changes.txt:266 497f2dbf904a4835bd5ae4ec277a1bed +msgid "" +"**Fixed** `#2110 `_: " +"Fully embedded font is extracted only partially if it occupies more than " +"one object" +msgstr "" + +#: ../../../changes.txt:267 c2ccbee522224a3ba83a4586a04b9124 +msgid "" +"**Fixed** `#2094 `_: " +"Rectangle Detection Logic" +msgstr "" + +#: ../../../changes.txt:268 07c42fe1bb8f4bf79b0413a9b70f2c34 +msgid "" +"**Fixed** `#2088 `_: " +"Destination point not set for named links in toc" +msgstr "" + +#: ../../../changes.txt:269 a4dd2034edd5479fa495d23ea689d20f +msgid "" +"**Fixed** `#2087 `_: " +"Image with Filter \"[/FlateDecode/JPXDecode]\" not extracted" +msgstr "" + +#: ../../../changes.txt:270 d0a14b469c5f4bf6b9cc76a7288a281c +msgid "" +"**Fixed** `#2086 `_: " +"Document.save() owner_pw & user_pw has buffer overflow bug" +msgstr "" + +#: ../../../changes.txt:271 60c5d5dcd8fe4e3d86e787e2c3d3f056 +msgid "" +"**Fixed** `#2076 `_: " +"Segfault in fitz.py" +msgstr "" + +#: ../../../changes.txt:272 62b1a89b24664219b22cecad479f8336 +msgid "" +"**Fixed** `#2057 `_: " +"Document.save garbage parameter not working in PyMuPDF 1.21.0" +msgstr "" + +#: ../../../changes.txt:273 47979d97236d4e7abad460b410508862 +msgid "" +"**Fixed** `#2051 `_: " +"Missing DPI Parameter" +msgstr "" + +#: ../../../changes.txt:274 3be348902fe44297bff6c608add727fe +msgid "" +"**Fixed** `#2048 `_: " +"Invalid size of TextPage and bbox with newest version 1.21.0" +msgstr "" + +#: ../../../changes.txt:275 5aef5fae33b345318e8a7d244021189c +msgid "" +"**Fixed** `#2045 `_: " +"SystemError: returned a result " +"with an error set" +msgstr "" + +#: ../../../changes.txt:276 462842c40d5340da9e7151c850b090f4 +msgid "" +"**Fixed** `#2039 `_: " +"1.21.0 fails to build against system libmupdf" +msgstr "" + +#: ../../../changes.txt:277 b2a43069d79a4094be1e52148881a30e +msgid "" +"**Fixed** `#2036 `_: " +"Archive::Archive defined twice" +msgstr "" + +#: ../../../changes.txt:279 bdb55edeba144783b08183812d018a5a +msgid "Other" +msgstr "" + +#: ../../../changes.txt:281 8de506b3ec78434990ad35efae35577d +msgid "Swallow \"&zoom=nan\" in link uri strings." +msgstr "" + +#: ../../../changes.txt:282 4ac3ab9580d045608e13a1e43602eba1 +msgid "" +"Add new Page utility methods ``Page.replace_image()`` and " +"``Page.delete_image()``." +msgstr "" + +#: ../../../changes.txt:286 c33b8fdb1eed493baedac743dfd56dc5 +msgid "" +"`#2040 `_: Added note " +"about test failure with non-default build of MuPDF, to " +"``tests/README.md``." +msgstr "" + +#: ../../../changes.txt:287 21a50da34d8f4ef98c1c657846fc0cc1 +msgid "" +"`#2037 `_: In " +"``docs/installation.rst``, mention incompatibility with chocolatey.org on" +" Windows." +msgstr "" + +#: ../../../changes.txt:288 749d1da0a7764117bb33ed2bb687ce8e +msgid "" +"`#2061 `_: Fixed " +"description of ``Annot.file_info``." +msgstr "" + +#: ../../../changes.txt:289 1167a56663ac40e099581cd4deaf190b +msgid "" +"`#2065 `_: Show how to " +"insert internal PDF link." +msgstr "" + +#: ../../../changes.txt:290 8496296be5c74ca687838711b53b8f34 +msgid "Improved description of building from source without an sdist." +msgstr "" + +#: ../../../changes.txt:291 eb3ce3f70a914539b92dfb637475c81c +msgid "Added information about running tests." +msgstr "" + +#: ../../../changes.txt:292 33464b810e1a4bc6b8b0791e7f71f170 +msgid "" +"`#2084 `_: Fixed broken " +"link to PyMuPDF-Utilities." +msgstr "" + +#: ../../../changes.txt:295 04078d752fd94d82a26dee55d7b9852a +msgid "**Changes in Version 1.21.0 (2022-11-8)**" +msgstr "" + +#: ../../../changes.txt:297 d3858ddbd34b426096dadb7eeedd73f9 +msgid "This release uses ``MuPDF-1.21.0``." +msgstr "" + +#: ../../../changes.txt:299 2b8fe055c7714d37aece4477bc27841a +msgid "New feature: Stories." +msgstr "" + +#: ../../../changes.txt:301 ee5a04ec1187413582619d4fd1c5246c +msgid "Added wheels for Python-3.11." +msgstr "" + +#: ../../../changes.txt:305 73a3c93eb50f49c88fd6086f7ab680b3 +msgid "" +"**Fixed** `#1701 `_: " +"Broken custom image insertion." +msgstr "" + +#: ../../../changes.txt:306 67ad7835a4da4995828eddd66d2f416f +msgid "" +"**Fixed** `#1854 `_: " +"`Document.delete_pages()` declines keyword arguments." +msgstr "" + +#: ../../../changes.txt:307 53bb8339dcf24e05a753aee7ca9b8d41 +msgid "" +"**Fixed** `#1868 `_: " +"Access Violation Error at `page.apply_redactions()`." +msgstr "" + +#: ../../../changes.txt:308 60523fb2965b4509a235cbab921fad7f +msgid "" +"**Fixed** `#1909 `_: " +"Adding text with `fontname=\"Helvetica\"` can silently fail." +msgstr "" + +#: ../../../changes.txt:309 1641ff279cf64ae7b31c39dfb4a49a02 +msgid "" +"**Fixed** `#1913 `_: " +"`draw_rect()`: does not respect width if color is not specified." +msgstr "" + +#: ../../../changes.txt:310 64ed002323e24b6eb9eb6ca3e9a67d49 +msgid "" +"**Fixed** `#1917 `_: " +"`subset_fonts()`: make it possible to silence the stdout." +msgstr "" + +#: ../../../changes.txt:311 1100859814ba4a119788754d67a04e37 +msgid "" +"**Fixed** `#1936 `_: " +"Rectangle detection can be incorrect producing wrong output." +msgstr "" + +#: ../../../changes.txt:312 92b7094094994115aac0e7a40236efaf +msgid "" +"**Fixed** `#1945 `_: " +"Segmentation fault when saving with `clean=True`." +msgstr "" + +#: ../../../changes.txt:313 ee67cb1298aa4dd29100618f0cd7767c +msgid "" +"**Fixed** `#1965 `_: " +"`pdfocr_save()` Hard Crash." +msgstr "" + +#: ../../../changes.txt:314 5b998f12d39a45a89773d7707942cd29 +msgid "" +"**Fixed** `#1971 `_: " +"Segmentation fault when using `get_drawings()`." +msgstr "" + +#: ../../../changes.txt:315 13b0f72c10ea48e69086c58b3c9846f2 +msgid "" +"**Fixed** `#1946 `_: " +"`block_no` and `block_type` switched in `get_text()` docs." +msgstr "" + +#: ../../../changes.txt:316 aa7ff258a86245269720c80961ea33c8 +msgid "" +"**Fixed** `#2013 `_: " +"AttributeError: 'Widget' object has no attribute '_annot' in delete " +"widget." +msgstr "" + +#: ../../../changes.txt:318 d6f445c9eee04a18ab21c956043602f8 +msgid "Misc changes to core code:" +msgstr "" + +#: ../../../changes.txt:320 37383ca6d76341aa9b2640f690772123 +msgid "Fixed various compiler warnings and a sequence-point bug." +msgstr "" + +#: ../../../changes.txt:321 001e6805a059465381bda468e3f1b86f +msgid "Added support for Memento builds." +msgstr "" + +#: ../../../changes.txt:322 9f6222fef741461e84a9d95326ec7096 +msgid "Fixed leaks detected by Memento in test suite." +msgstr "" + +#: ../../../changes.txt:323 814e800c0a8e4cd385afe6499299bd31 +msgid "Fixed handling of exceptions in set_name() and set_rect()." +msgstr "" + +#: ../../../changes.txt:324 d0cc7ec3bd0b458b80e5fb948d3cd4cb +msgid "Allow build with latest MuPDF, for regular testing of PyMuPDF master." +msgstr "" + +#: ../../../changes.txt:325 ef03d6f1540c450a878f85bbc4bde768 +msgid "Cope with new MuPDF exceptions when setting rect for some Annot types." +msgstr "" + +#: ../../../changes.txt:326 9be2d15643dd4a4fbdaf48ed905c698b +msgid "" +"Reduced cosmetic differences between MuPDF's config.h and PyMuPDF's " +"_config.h." +msgstr "" + +#: ../../../changes.txt:327 29b579e311954d5e8ff33157d4aa9653 +msgid "Cope with various changes to MuPDF API." +msgstr "" + +#: ../../../changes.txt:331 347a3233b1304e99891acbe3e5e42b0e +msgid "Fixed various broken links and typos in docs." +msgstr "" + +#: ../../../changes.txt:332 4b310a8248cc4f49bf3370a09787fd1b +msgid "Mention install of `swig-python` on MacOS for #875." +msgstr "" + +#: ../../../changes.txt:333 fa2885e0cf054b2cb1b52bda6423ff4e +msgid "Added (untested) wheels for macos-arm64." +msgstr "" + +#: ../../../changes.txt:338 a327e5012fc842b399f815e78df9e05f +msgid "**Changes in Version 1.20.2**" +msgstr "" + +#: ../../../changes.txt:340 db9c1a02a22b4c58b50c7f5ef48cdc5e +msgid "This release uses ``MuPDF-1.20.3``." +msgstr "" + +#: ../../../changes.txt:342 daf56f09dedb4bea8879529a2e79f167 +msgid "" +"**Fixed** `#1787 `_. Fix " +"linking issues on Unix systems." +msgstr "" + +#: ../../../changes.txt:345 880b8aade8934ea9b39f7f226b847f72 +msgid "" +"**Fixed** `#1824 `_. " +"SegFault when applying redactions overlapping a transparent image. (Fixed" +" in ``MuPDF-1.20.3``.)" +msgstr "" + +#: ../../../changes.txt:349 151312b005de42779e15281a619f5525 +msgid "Improvements to documentation:" +msgstr "" + +#: ../../../changes.txt:351 d85bb80b7d3245d9abc304b57380ee75 +msgid "" +"Improved information about building from source in " +"``docs/installation.rst``." +msgstr "" + +#: ../../../changes.txt:352 f557519eb0f94cba8a04da45e56c25da +msgid "Clarified memory allocation setting ``JM_MEMORY` in ``docs/tools.rst``." +msgstr "" + +#: ../../../changes.txt:353 9a96070bf0c04f8b811a278dc78d3b14 +msgid "Fixed link to PDF Reference manual in ``docs/app3.rst``." +msgstr "" + +#: ../../../changes.txt:354 08193cd1ae1f44589f25e85564f9d606 +msgid "Fixed building of html documentation on OpenBSD." +msgstr "" + +#: ../../../changes.txt:355 42a0699c46c74254afcdd8a0076493c0 +msgid "Moved old ``docs/faq.rst`` into separate ``docs/recipes-*`` files." +msgstr "" + +#: ../../../changes.txt:357 75321dad124b490c8a65889b983ad453 +msgid "Removed some unused files and directories:" +msgstr "" + +#: ../../../changes.txt:359 9e0feefda08148f6b0750678463c6fa1 +msgid "``installation/``" +msgstr "" + +#: ../../../changes.txt:360 869c7d92b24a4c7596b9359c582a6b6e +msgid "``docs/wheelnames.txt``" +msgstr "" + +#: ../../../changes.txt:363 ba8aac8f47cf49e997df25d2353b6407 +msgid "**Changes in Version 1.20.1**" +msgstr "" + +#: ../../../changes.txt:365 8a1ec825792046899ca70fce14439897 +msgid "" +"**Fixed** `#1724 `_. Fix " +"for building on FreeBSD." +msgstr "" + +#: ../../../changes.txt:368 49442fdd15a9416ca284b70c6803a3e4 +msgid "" +"**Fixed** `#1771 `_. " +"`linkDest()` had a broken call to `re.match()`, introduced in 1.20.0." +msgstr "" + +#: ../../../changes.txt:371 0dc285ccbbb84966957dd4f94f19faa9 +msgid "" +"**Fixed** `#1751 `_. " +"`get_drawings()` and `get_cdrawings()` previously always returned with " +"`closePath=False`." +msgstr "" + +#: ../../../changes.txt:374 ba609fe85b4246e18e24cee9da71f078 +msgid "" +"**Fixed** `#1645 `_. " +"Default FreeText annotation text color is now black." +msgstr "" + +#: ../../../changes.txt:377 e0b52f0df79146db8b243907bbe29f1a +msgid "Improvements to sphinx-generated documentation:" +msgstr "" + +#: ../../../changes.txt:379 1fd848ba8fe04c2e8f8dbc73367f60ca +msgid "Use readthedocs theme with enhancements." +msgstr "" + +#: ../../../changes.txt:380 5abfed1d2aa04038aac01a214afa2e6f +msgid "Renamed the `.txt` files to have `.rst` suffixes." +msgstr "" + +#: ../../../changes.txt:384 057284bcaf32453eb1f1cf246ae1d73b +msgid "**Changes in Version 1.20.0**" +msgstr "" + +#: ../../../changes.txt:386 decd1e7dfac34a3d82662b8b47735fe8 +msgid "This release uses ``MuPDF-1.20.0``, released 2022-06-15." +msgstr "" + +#: ../../../changes.txt:388 085bbc1ae929493383538e241c436494 +msgid "" +"Cope with new MuPDF link uri format, changed from ``#,,`` " +"to ``#page=&zoom=,,``." +msgstr "" + +#: ../../../changes.txt:390 1288b8f2d3fb441ab44bf2abc8650b22 +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:392 85bd750b221049a5adaa329af5580f09 +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:395 c42582c92683489499b205d56430c1de +msgid "" +"**Fixed** `#1733 `_. " +"Fixed ownership of `Annotation.get_pixmap()`." +msgstr "" + +#: ../../../changes.txt:397 496b0d05aff444749c3c411099f9c9cb +msgid "Changes to build/release process:" +msgstr "" + +#: ../../../changes.txt:399 d9b7bc724bba41a0b776ee7b2221bede +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:401 766e8685f2e5467a93db8fe75575c0c0 +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:403 11a6e9612417474394a2a26e205cc757 +msgid "" +"Added ``.github/workflows/build_wheels.yml`` to control building of " +"wheels on Github." +msgstr "" + +#: ../../../changes.txt:407 57822be90f594b3e9cbf2d7426584607 +msgid "**Changes in Version 1.19.6**" +msgstr "" + +#: ../../../changes.txt:409 dad308efd3c244fd9d318ab60ca58ae5 +msgid "" +"**Fixed** `#1620 `_. The " +":ref:`TextPage` created by :meth:`Page.get_textpage` will now be freed " +"correctly (removed memory leak)." +msgstr "" + +#: ../../../changes.txt:410 d1da2753922445df8445b6e4d9e5c719 +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:412 68ac7db62b9945c7b0ab820265c8e12e +msgid "" +"``EmptyFileError`` -- raised when trying to create a :ref:`Document` " +"(``fitz.open()``) from an empty file or zero-length memory." +msgstr "" + +#: ../../../changes.txt:413 97f77819a0fa4fbdb950bba7e62ebe44 +msgid "" +"``FileDataError`` -- raised when MuPDF encounters irrecoverable document " +"structure issues." +msgstr "" + +#: ../../../changes.txt:415 215178550f684acd99cf7823eab80b58 +msgid "**Added** :meth:`Page.load_widget` given a PDF field's xref." +msgstr "" + +#: ../../../changes.txt:417 e06cf47046f048f39a2f0c329f2c12b0 +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:419 c9a2231155434d7f967b30b737cdc17d +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:421 96836d042d874744b3d8bcebbb699c1d +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:423 ac5ae2e80fec4abc9b6b4b97e9adb23d +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:425 dd1a1033fab74c54ba9ba15cc0cbcfde +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:427 fd9b00bb4b194e1e9afaf1ad0213cd73 +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:432 c4c35bc16fea4196a269c5dc7ccb8726 +msgid "**Changes in Version 1.19.5**" +msgstr "" + +#: ../../../changes.txt:434 bb1575242fe94adb8eeb8550ea558117 +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:436 122e18568b0c41d6be313aba27296e19 +msgid "" +"**Fixed** `#1521 `_. This" +" had the same ultimate reason behind issue #1510." +msgstr "" + +#: ../../../changes.txt:438 c6f38d696c084e55a5c6097cc77194e4 +msgid "" +"**Fixed** `#1513 `_. Some" +" Optional Content functions did not support non-ASCII characters." +msgstr "" + +#: ../../../changes.txt:440 f4f1b10a7a2d422d965f7e05f0cf2982 +msgid "" +"**Fixed** `#1510 `_. " +"Support more soft-mask image subtypes." +msgstr "" + +#: ../../../changes.txt:442 5c7230abae7644329adf9f0f69df8bf9 +msgid "" +"**Fixed** `#1507 `_. " +"Immunize against items in the outlines chain, that are ``\"null\"`` " +"objects." +msgstr "" + +#: ../../../changes.txt:444 c904f452e8b04cf388e973fb829300a7 +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:446 48b1e2812e3c4a3894071b5cfc3fc3fd +msgid "" +"**Fixed** several undocumented issues in relation to incorrectly setting " +"the text span origin :data:`point_like`." +msgstr "" + +#: ../../../changes.txt:448 4082863789614b8cb07a07ea246686a8 +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:450 e2008315256d44878b7e3d8fd723c1be +msgid "" +"**Added** items to the dictionary returned by :meth:`image_properties`: " +"``orientation`` and ``transform`` report the natural image orientation " +"(EXIF data)." +msgstr "" + +#: ../../../changes.txt:452 badc87e6c0e94dac81009db32829cd02 +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:457 07abb3b2c1064fb280ba83d3842a0a61 +msgid "**Changes in Version 1.19.4**" +msgstr "" + +#: ../../../changes.txt:460 e3452f6f33264ec9b39eea4dd983db3b +msgid "" +"**Fixed** `#1505 `_. " +"Immunize against circular outline items." +msgstr "" + +#: ../../../changes.txt:462 99502c4ad1df4a0680da102986c8fd92 +msgid "" +"**Fixed** `#1484 `_. " +"Correct CropBox coordinates are now returned in all situations." +msgstr "" + +#: ../../../changes.txt:464 4340b260ce284cafb53b626f888cfc5a +msgid "**Fixed** `#1479 `_." +msgstr "" + +#: ../../../changes.txt:466 cd8868467ccc4ad9b147a83ca7c0cf35 +msgid "" +"**Fixed** `#1474 `_. " +"TextPage objects are now properly deleted again." +msgstr "" + +#: ../../../changes.txt:468 e6c4441dd15444609127c51915381d3a +msgid "" +"**Added** :ref:`Page` methods and attributes for PDF ``/ArtBox``, " +"``/BleedBox``, ``/TrimBox``." +msgstr "" + +#: ../../../changes.txt:470 1b891dafb4034bd6bd986a40f9deb840 +msgid "" +"**Added** global attribute :attr:`TESSDATA_PREFIX` for easy checking of " +"OCR support." +msgstr "" + +#: ../../../changes.txt:472 4f52d31327e04c9c977cfd220e98a2c9 +msgid "" +"**Changed** :meth:`Document.xref_set_key` such that dictionary keys will " +"physically be removed if set to value ``\"null\"``." +msgstr "" + +#: ../../../changes.txt:474 7ba4402651064177ba7f23fb7ce2e72a +msgid "" +"**Changed** :meth:`Document.extract_font` to optionally return a " +"dictionary (instead of a tuple)." +msgstr "" + +#: ../../../changes.txt:478 5886a74bd7fe4c56ae430ab65080a9b3 +msgid "**Changes in Version 1.19.3**" +msgstr "" + +#: ../../../changes.txt:480 814ba42ceee545ab8414190f8ea9d430 +msgid "" +"This patch version implements minor improvements for :ref:`Pixmap` and " +"also some important fixes." +msgstr "" + +#: ../../../changes.txt:482 9dbabbd81b6f4c49b2a6f1d575bec97e +msgid "" +"**Fixed** `#1351 `_." +" Reverted code that introduced the memory growth in v1.18.15." +msgstr "" + +#: ../../../changes.txt:484 0d7bc5b4b88b4baa909b69bdc3fec12b +msgid "" +"**Fixed** `#1417 `_." +" Developped circumvention for growth of open file handles using " +":meth:`Document.insert_pdf`." +msgstr "" + +#: ../../../changes.txt:486 4279258b1d954317a21fec2886348ea6 +msgid "" +"**Fixed** `#1418 `_." +" Developped circumvention for memory growth using " +":meth:`Document.insert_pdf`." +msgstr "" + +#: ../../../changes.txt:488 04fc6520d7fd47a4a4d2831ba28c8e82 +msgid "" +"**Fixed** `#1430 `_." +" Developped circumvention for mass pixmap generations of document pages." +msgstr "" + +#: ../../../changes.txt:490 d96bff482c554b4dbf737cbad3a09f00 +msgid "" +"**Fixed** `#1433 `_." +" Solves a bbox error for some Type 3 font in PyMuPDF text processing." +msgstr "" + +#: ../../../changes.txt:492 6f27172e72e545f79617bd31c3e6f795 +msgid "" +"**Added** :meth:`Pixmap.color_topusage` to determine the share of the " +"most frequently used color. Solves `#1397 " +"`_." +msgstr "" + +#: ../../../changes.txt:494 26a7b0f497bb4d56b9a998787c5321ce +msgid "" +"**Added** :meth:`Pixmap.warp` which makes a new pixmap from a given " +"arbitrary convex quad inside the pixmap." +msgstr "" + +#: ../../../changes.txt:496 66c7d4894f784947916c212ab9dd37d0 +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:498 bd648a284e8b402e9d8880a67a5d2e85 +msgid "" +"**Added** :meth:`Rect.torect` and :meth:`IRect.torect` which compute a " +"matrix that transforms to a given other rectangle." +msgstr "" + +#: ../../../changes.txt:500 16b1e2d856954f7496ff6b5092235d84 +msgid "" +"**Changed** :meth:`Pixmap.color_count` to also return the count of each " +"color." +msgstr "" + +#: ../../../changes.txt:501 b31afafe5f544c188475fb775f9a462c +msgid "" +"**Changed** :meth:`Page.get_texttrace` to also return correct span and " +"character bboxes if ``span[\"dir\"] != (1, 0)``." +msgstr "" + +#: ../../../changes.txt:505 789b4fcb5b0a422cbe8c044c996c637d +msgid "**Changes in Version 1.19.2**" +msgstr "" + +#: ../../../changes.txt:507 72f271f52b87482aad937eeb50460f55 +msgid "" +"This patch version implements minor improvements for " +":meth:`Page.get_drawings` and also some important fixes." +msgstr "" + +#: ../../../changes.txt:509 f6b991cd14cf4101b7b1bf280ca42dfa +msgid "" +"**Fixed** `#1388 `_." +" Fixed intermittent memory corruption when insert or updating " +"annotations." +msgstr "" + +#: ../../../changes.txt:511 85c46015773c4e5b8504d6190177573d +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:513 7a5501f34464431fa9fe9fc0bb75cc4c +msgid "" +"**Fixed** `#1364 `_. The " +"check for being a ``\"rawdict\"`` span in :meth:`recover_span_quad` now " +"works correctly." +msgstr "" + +#: ../../../changes.txt:515 184a0450cb864719a9bf351e5bc4b2fd +msgid "" +"**Fixed** `#1342 `_. " +"Corrected the check for rectangle infiniteness in " +":meth:`Page.show_pdf_page`." +msgstr "" + +#: ../../../changes.txt:517 a92c38891c634c2f97b6d1e90034f001 +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:519 f178b3faaccf4c23913a6b338b61f8dc +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:521 9fcee124856b4181abedd347e9394165 +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:523 e9da5637f6054e75a53d5fdd5fa83953 +msgid "" +"**Added** attributes :attr:`Pixmap.is_monochrome` and " +":attr:`Pixmap.is_unicolor` allowing fast checks of pixmap properties. " +"Addresses `#1397 `_." +msgstr "" + +#: ../../../changes.txt:525 5f8d797cc42e4a028d4ee8c7dbca68ee +msgid "" +"**Added** method :meth:`Pixmap.color_count` to determine the unique " +"colors in the pixmap." +msgstr "" + +#: ../../../changes.txt:527 de281f860f89447e9090aa57c6cec242 +msgid "" +"**Added** boolean parameter ``\"compress\"`` to PDF document method " +":meth:`Document.update_stream`. Addresses / enables solution for `#1408 " +"`_." +msgstr "" + +#: ../../../changes.txt:531 a1ecf49929b94d47a4517d9f8d93d8ff +msgid "**Changes in Version 1.19.1**" +msgstr "" + +#: ../../../changes.txt:533 80a791e082eb46bf8cef97f6d1d9ec9d +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:535 d828b8c5fe8e47259ced8b71a03ecd95 +msgid "" +"**Fixed** `#1328 `_. " +"\"words\" text extraction again returns correct ``(x0, y0)`` coordinates." +msgstr "" + +#: ../../../changes.txt:537 9af730f775bf4530a0297d37735712a9 +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:539 e12982e170e04e8cad81e4ee0d522bed +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:541 d4480466202544389d003e75b101b7ee +msgid "" +"**Changed** :meth:`Page.get_text` to support a parameter ``sort``. If set" +" to ``True`` the output is conveniently sorted." +msgstr "" + +#: ../../../changes.txt:546 4ff33fadbbbe445894616f886b66e616 +msgid "**Changes in Version 1.19.0**" +msgstr "" + +#: ../../../changes.txt:548 589499cf480a4d748e236c6d9228aaad +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:550 35782b5cb1944485a4b2ac37311d0d1a +msgid "" +"PyMuPDF has now picked up integrated Tesseract OCR support, which was " +"already present in MuPDF v1.18.0." +msgstr "" + +#: ../../../changes.txt:552 dc6b1ee9449841e5a6c94dc16a2d8bea +msgid "" +"Supported images can be OCRed via their :ref:`Pixmap` which results in a " +"1-page PDF with a text layer." +msgstr "" + +#: ../../../changes.txt:553 ede34357445b4ce4b9900a27965e718b +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:554 9b51826af75c481ca8f4fc2f5bbe52b1 +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:556 198211f49b564b7cb93f1bdd33117e8f +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:558 0fec2b6b17e640fe993af98884d0bc83 +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:560 ae73ca993eea4095aaaf829c0046238e +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:562 2d113987c36244a8894b085b7c32c050 +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:564 f6bfc89d22ee4c5a88e388f17f040c5e +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:566 90c63e360a164fa79ae3584fb6158ab1 +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:568 88c66709c0c14bacb775ca5d6e0c0537 +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:570 d43efd6439fc48c9ac4ee06d8b2c22d5 +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:572 5b97282e0c93408ea7ab575e77a36610 +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:574 c65b874c4d804e13b2bb18cdb43a821b +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:576 034d16a243bb4713a67cb3adea886c0e +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:578 0efc4477cdc249258dea3bd1274b6421 +msgid "" +"**Fixed** `#1311 `_. " +"Field values in comboboxes should now be handled correctly." +msgstr "" + +#: ../../../changes.txt:579 b14767a262bb47bb8eaf739164b55653 +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:580 627e84f84cb242c18a48f1f57ba5382e +msgid "" +"**Fixed** `#1286 `_. Text" +" alignment for redact annotations is working again." +msgstr "" + +#: ../../../changes.txt:581 a05d5ec17f9f4d6c9ac297ea07138999 +msgid "" +"**Fixed** `#1287 `_. " +"Infinite loop issue for non-Windows systems when applying some redactions" +" has been resolved." +msgstr "" + +#: ../../../changes.txt:582 60c4527ed23444e2b749685d26ffdf62 +msgid "" +"**Fixed** `#1284 `_. Text" +" layout destruction after applying redactions in some cases has been " +"resolved." +msgstr "" + +#: ../../../changes.txt:586 d1d9a1674dab40ba8a4412f60f406e8b +msgid "**Changes in Version 1.18.18 / 1.18.19**" +msgstr "" + +#: ../../../changes.txt:588 92fad59079b64348b7cab8ad718494a8 +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:590 9271baa4166346f2a0cf2890d63ac957 +msgid "" +"**Fixed** issue `#1257 " +"`_. Removing the read-" +"only flag from PDF fields is now possible." +msgstr "" + +#: ../../../changes.txt:592 a54017d38ae54e0aa19326be29014852 +msgid "" +"**Fixed** issue `#1252 " +"`_. Now correctly " +"specifying the ``zoom`` value for PDF link annotations." +msgstr "" + +#: ../../../changes.txt:594 0c356456b5004a4dbdfc47ec5231d3ab +msgid "" +"**Fixed** issue `#1244 " +"`_. Now correctly " +"computing the transform matrix in :meth:`Page.get_image__bbox`." +msgstr "" + +#: ../../../changes.txt:596 7ca7319d6ba34b858538e03689ee3a40 +msgid "" +"**Fixed** issue `#1241 " +"`_. Prevent returning " +"artifact characters in :meth:`Page.get_textbox`, which happened in " +"certain constellations." +msgstr "" + +#: ../../../changes.txt:598 99ba08073027429fa799973f730db4c8 +msgid "" +"**Fixed** issue `#1234 " +"`_. Avoid creating " +"infinite rectangles in corner cases -- :meth:`Page.get_drawings`, " +":meth:`Page.get_cdrawings`." +msgstr "" + +#: ../../../changes.txt:600 fa78a338a07a4b48a194b9b596cd652e +msgid "" +"**Added** test data and test scripts to the source PyPI source " +"distribution." +msgstr "" + +#: ../../../changes.txt:604 927332fd8a824c32adeb5b26e21c2e4a +msgid "**Changes in Version 1.18.17**" +msgstr "" + +#: ../../../changes.txt:606 2bcd11d43ecb4ddfa0fa5446c0e6d6ec +msgid "" +"Focus of this version are major performance improvements of selected " +"functions." +msgstr "" + +#: ../../../changes.txt:608 b978d1dbd1844392bffd33c07930315a +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:610 15b545b86347496fadbcce25bb6c06f4 +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:612 4e13a6b671e84fca862108d0ca46a1c7 +msgid "" +"**Added** :meth:`Page.get_cdrawings`, performance-optimized version of " +":meth:`Page.get_drawings`." +msgstr "" + +#: ../../../changes.txt:614 4b6876d0370c4e4abec1135cc5413deb +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:616 5d123e2567c94358a11ec60a6bbb8850 +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:622 2756848732dc41948d5eca387055feea +msgid "**Changes in Version 1.18.16**" +msgstr "" + +#: ../../../changes.txt:624 3e802a1a02134447aaa855670465be86 +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:626 bbbfa1cb97c140ad9967f6968ef0f240 +msgid "" +"**Fixed** issue `#1154 " +"`_. Text search hits " +"should now be correct when ``clip`` is specified." +msgstr "" + +#: ../../../changes.txt:628 c232c4e785914be3a8bf5c9dfc38e651 +msgid "**Fixed** issue `#1152 `_." +msgstr "" + +#: ../../../changes.txt:630 ced4bff6980c40e292846929dffa298c +msgid "**Fixed** issue `#1146 `_." +msgstr "" + +#: ../../../changes.txt:632 2221ece0785b4434b759129c1ea6107a +msgid "" +"**Added** :attr:`Link.flags` and :meth:`Link.set_flags` to the " +":ref:`Link` class. Implements enhancement requests `#1187 " +"`_." +msgstr "" + +#: ../../../changes.txt:634 d660a317aa6a41a4abf679a9e9e1f227 +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:636 7a0adc73e2494b03adc01aacacc40ff7 +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:641 1389da583cc4419b8a934f8ba23e7527 +msgid "**Changes in Version 1.18.15**" +msgstr "" + +#: ../../../changes.txt:643 3f225cde1daf40e8920ca6d7099aebfb +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:645 c48914a7605843e1a92211eb39b03601 +msgid "" +"**Fixed** issue `#1081 " +"`_. " +":meth:`Document.subset_fonts`: fixed an error which created wrong " +"character widths for some fonts." +msgstr "" + +#: ../../../changes.txt:647 1b01fe84f25a4d23ace14c5487269bbe +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:649 c91f61cd222041de9014702a20e4f9f7 +msgid "" +"**Fixed** issue `#1085 " +"`_. The old *snake_cased*" +" alias of ``fitz.detTextlength`` is now defined correctly." +msgstr "" + +#: ../../../changes.txt:651 ab7c259c4f2d463fa157e8102e91c038 +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:653 1708629cbf44443e8a9a4fc861a4a860 +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:655 dead2786541e4d6aaceb11f7d9ee5734 +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:660 bc27d78da3994c7a91c56b950b17b73b +msgid "**Changes in Version 1.18.14**" +msgstr "" + +#: ../../../changes.txt:662 41656df5813e4a188b8a22a994e5c4d4 +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:664 6caf53dcdd5f4efeb3e3c6af4035a40d +msgid "" +"**Fixed** issue `#1053 " +"`_. " +":meth:`Page.insert_image`: when given, include image mask in the hash " +"computation." +msgstr "" + +#: ../../../changes.txt:666 f135c0e3b2fb472e9d707b4ec17d0218 +msgid "" +"**Fixed** issue `#1043 " +"`_. Added " +"``Pixmap.getPNGdata`` to the aliases of :meth:`Pixmap.tobytes`." +msgstr "" + +#: ../../../changes.txt:668 ed14ac953c84494986893bc05b62a6cf +msgid "" +"**Fixed** an internal error when computing the enveloping rectangle of " +"drawn paths as returned by :meth:`Page.get_drawings`." +msgstr "" + +#: ../../../changes.txt:670 b82ece9a78c9491ab3a5d849af420637 +msgid "" +"**Fixed** an internal error occasionally causing loops when outputting " +"text via :meth:`TextWriter.fill_textbox`." +msgstr "" + +#: ../../../changes.txt:672 22960c5034e04ddf88cc9af888b5195d +msgid "" +"**Added** :meth:`Font.char_lengths`, which returns a tuple of character " +"widths of a string." +msgstr "" + +#: ../../../changes.txt:674 7d93995625254472b2743b3a45fe7519 +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:676 851878d77a6a4b9491d2eeb812a43381 +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:681 5458941bc24545db89fb1cb9766eeca6 +msgid "**Changes in Version 1.18.13**" +msgstr "" + +#: ../../../changes.txt:683 f724980bb30f4e47a556970baf9b07bc +msgid "**Fixed** issue `#1014 `_." +msgstr "" + +#: ../../../changes.txt:684 ddbed887789442ae94bb5f94f28c0e91 +msgid "" +"**Fixed** an internal memory leak when computing image bboxes -- " +":meth:`Page.get_image_bbox`." +msgstr "" + +#: ../../../changes.txt:685 e0a248e8e6fe42bb82cc2145c91d90c4 +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:686 5662b1da2c444f9da1ab79ce3a247697 +msgid "**Added** documentation for maintaining private entries in PDF metadata." +msgstr "" + +#: ../../../changes.txt:687 ec4261fd156c48c2a88a0a7775c705dd +msgid "" +"**Added** documentation for handling transparent image insertions, " +":meth:`Page.insert_image`." +msgstr "" + +#: ../../../changes.txt:688 eda867ab64e34d9ebbbf32339e64b7fa +msgid "" +"**Added** :meth:`Page.get_image_rects`, an improved version of " +":meth:`Page.get_image_bbox`." +msgstr "" + +#: ../../../changes.txt:689 ee3bb32b839d4d88bfc0776dcdede292 +msgid "" +"**Changed** :meth:`Document.delete_pages` to support various ways of " +"specifying pages to delete. Implements `#1042 " +"`_." +msgstr "" + +#: ../../../changes.txt:690 74d64cc237154635b45d10806f981fc0 +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:691 9eaaea325a6344f8b28ea058c86a0d88 +msgid "" +"**Changed** :meth:`Page.insert_image` to also accept the integer " +"parameter ``alpha``. To be used for performance improvements." +msgstr "" + +#: ../../../changes.txt:692 4e6c9e8f919a468e91ed8e0ab4eaab56 +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:693 9f4d6d8e7aa74e1491614505a66e9319 +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:697 9d98e70df9fc437d8830438da9070b4e +msgid "**Changes in Version 1.18.11 / 1.18.12**" +msgstr "" + +#: ../../../changes.txt:699 c1f2fb42261f4c15a15524e22ecba2f8 +msgid "" +"**Fixed** issue `#972 `_. " +"Improved layout of source distribution material." +msgstr "" + +#: ../../../changes.txt:700 4e239a90d20d4cbb936cf9400437dc26 +msgid "" +"**Fixed** issue `#962 `_. " +"Stabilized Linux distribution detection for generating PyMuPDF from " +"sources." +msgstr "" + +#: ../../../changes.txt:701 937833565d004f34aea063a1f4fda8ff +msgid "" +"**Added:** :meth:`Page.get_xobjects` delivers the result of " +":meth:`Document.get_page_xobjects`." +msgstr "" + +#: ../../../changes.txt:702 4f84ca04f90348bf96eb457fd745f6fe +msgid "" +"**Added:** :meth:`Page.get_image_info` delivers meta information for all " +"images shown on the page." +msgstr "" + +#: ../../../changes.txt:703 d22c6fbe38c94aef8d4198d77b7847bb +msgid "" +"**Added:** :meth:`Tools.mupdf_display_warnings` allows setting on / off " +"the display of MuPDF-generated warnings. The default is off." +msgstr "" + +#: ../../../changes.txt:704 e73c8a0a4f3d4cc0a17c9150170bf065 +msgid "" +"**Added:** :meth:`Document.ez_save` convenience alias of " +":meth:`Document.save` with some different defaults." +msgstr "" + +#: ../../../changes.txt:705 f648bd1ae6b547f09d6b4737d69e3ac8 +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:710 d6800117a7bb4e66a8f25f5f572c8d7d +msgid "**Changes in Version 1.18.10**" +msgstr "" + +#: ../../../changes.txt:712 3a6e1a75b97e4d79a1d5f15f6e0c1b9a +msgid "" +"**Fixed** issue `#941 `_. " +"Added old aliases for :meth:`DisplayList.get_pixmap` and " +":meth:`DisplayList.get_textpage`." +msgstr "" + +#: ../../../changes.txt:713 daeb4bdc3b494f6dbdd51416a8762a2b +msgid "" +"**Fixed** issue `#929 `_. " +"Stabilized removal of JavaScript objects with :meth:`Document.scrub`." +msgstr "" + +#: ../../../changes.txt:714 eef62ed4124145f1af26fb539d4f4779 +msgid "" +"**Fixed** issue `#927 `_. " +"Removed a loop in the reworked :meth:`TextWriter.fill_textbox`." +msgstr "" + +#: ../../../changes.txt:715 bf4030df20204bf0b126962dff5cfb85 +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:716 354d80a7cdbc4b6396c69312bc67e996 +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:717 623dff961e1a454fa4df0037bb02a13d +msgid "" +"**Added** :meth:`Tools.unset_quad_corrections` to suppress character quad" +" corrections (occasionally required for erroneous fonts)." +msgstr "" + +#: ../../../changes.txt:721 2f4fcc2cd25941d2af3151046e300824 +msgid "**Changes in Version 1.18.9**" +msgstr "" + +#: ../../../changes.txt:724 b2f2ea58f191486cb6a747f606defe0a +msgid "" +"**Fixed** issue `#888 `_. " +"Removed ambiguous statements concerning PyMuPDF's license, which is now " +"clearly stated to be GNU AGPL V3." +msgstr "" + +#: ../../../changes.txt:725 2b39381037a347bfa33b36037a4ee4f9 +msgid "**Fixed** issue `#895 `_." +msgstr "" + +#: ../../../changes.txt:726 62264e99ab20493286c03aa362ad7a99 +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:727 1c5eff82a09d459db78657c539f0f8d7 +msgid "" +"**Fixed** issue `#885 `_. " +"Pixmap creation now also works with filenames given as ``pathlib.Paths``." +msgstr "" + +#: ../../../changes.txt:728 579c7134ffec43a8ae23cf39d4f93bed +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:729 18e1f45ca70f444784389fe2e56be45c +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:730 b124b52a032f463aa5ed032137e2b8d6 +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:731 f801f2f1427a4d5d8882aef79c529433 +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:735 8ce35f1d7f3b40859c2195aa6eed321e +msgid "**Changes in Version 1.18.8**" +msgstr "" + +#: ../../../changes.txt:738 5ef59c8e06a94e5dbc89686da0d560c0 +msgid "" +"This is a bug fix version only. We are publishing early because of the " +"potentially widely used functions." +msgstr "" + +#: ../../../changes.txt:740 ff19261d16ee4cfabe65e79bac603ed1 +msgid "" +"**Fixed** issue `#881 `_. " +"Fixed a memory leak in :meth:`Page.insert_image` when inserting images " +"from files or memory." +msgstr "" + +#: ../../../changes.txt:741 8446991a073440e89c43bc1e1dcf0989 +msgid "" +"**Fixed** issue `#878 `_. " +"``pathlib.Path`` objects should now correctly handle file path " +"hierarchies." +msgstr "" + +#: ../../../changes.txt:746 540969db6c5b48acbf9b7913ae20f74d +msgid "**Changes in Version 1.18.7**" +msgstr "" + +#: ../../../changes.txt:749 2db3f295eb344bfe865e2ed30487306b +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:750 d0392563c85a40eead1ad7be91e88f42 +msgid "" +"**Implemented** request `#870 " +"`_: " +":meth:`Document.convert_to_pdf` now also supports PDF documents." +msgstr "" + +#: ../../../changes.txt:751 a14cfcf63e2744289aedc8e67b499f12 +msgid "" +"**Renamed** ``Document.write`` to :meth:`Document.tobytes` for greater " +"clarity. But the deprecated name remains available for some time." +msgstr "" + +#: ../../../changes.txt:752 a3bd03cfb5f14ce6a60ee90f8707fc23 +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:753 79c8160aa7104206819f023db08c5a7e +msgid "**Fixed** issue `#844 `_." +msgstr "" + +#: ../../../changes.txt:754 dfe73e759b6e49a48fea75f9f2253588 +msgid "**Fixed** issue `#838 `_." +msgstr "" + +#: ../../../changes.txt:755 3d7321397c2a4eaf8ba97985e5c9fac7 +msgid "" +"**Fixed** issue `#823 `_. " +"More logic for better support of OCRed text output (Tesseract, ABBYY)." +msgstr "" + +#: ../../../changes.txt:756 8c5b86da66624874895b4778a87fbb16 +msgid "**Fixed** issue `#818 `_." +msgstr "" + +#: ../../../changes.txt:757 38770df9717a452fb2ebe63d822930bf +msgid "**Fixed** issue `#814 `_." +msgstr "" + +#: ../../../changes.txt:758 c9652b902c184ff689c67576ee22bef4 +msgid "" +"**Added** :meth:`Document.get_page_labels` which returns a list of page " +"label definitions of a PDF." +msgstr "" + +#: ../../../changes.txt:759 dbc4dbbd2ed14891993ced90825d05f2 +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:760 d8bdd160bf5b48c392e842566e530e33 +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:761 9d6b2ed0aa5c406fb060e12cd0928462 +msgid "" +"**Added** parameter ``thumbnails`` to :meth:`Document.scrub` to also " +"allow removing page thumbnail images." +msgstr "" + +#: ../../../changes.txt:762 0fbdc5c38f1b4aa9853d350987fbf78b +msgid "" +"**Improved** documentation for how to add valid text marker annotations " +"for non-horizontal text." +msgstr "" + +#: ../../../changes.txt:764 5bb38489b3de4850b636d18356770144 +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:770 281c8c8b33334acc9be49d0a78638d76 +msgid "**Changes in Version 1.18.6**" +msgstr "" + +#: ../../../changes.txt:772 9417af6440b64770938158ceb9747d7f +msgid "**Fixed** issue `#812 `_." +msgstr "" + +#: ../../../changes.txt:773 f8ff0a644bee440bbdfadbf2461c8893 +msgid "" +"**Fixed** issue `#793 `_. " +"Invalid document metadata previously prevented opening some documents at " +"all. This error has been removed." +msgstr "" + +#: ../../../changes.txt:774 924e5ed6bc454420a73c2f9fea7cbdfd +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:775 10d3d40c71774acdbe5949667d3553d8 +msgid "**Fixed** issue `#785 `_." +msgstr "" + +#: ../../../changes.txt:776 edcc76b2b4824c4090295a941877c726 +msgid "" +"**Fixed** issue `#780 `_. " +"Corrected a parameter check error." +msgstr "" + +#: ../../../changes.txt:777 0f9ec0c137a14422baf782a29d0fe7a8 +msgid "" +"**Fixed** issue `#779 `_. " +"Fixed typo" +msgstr "" + +#: ../../../changes.txt:778 21ba422877f243b084d3ddf9cda8bb1c +msgid "" +"**Added** an option to set the desired line height for text boxes. " +"Implements `#804 `_." +msgstr "" + +#: ../../../changes.txt:779 e0db20d9e29a4ee6b30161a2fdc5334c +msgid "" +"**Changed** text position retrieval to better cope with Tesseract's " +"glyphless font. Implements `#803 " +"`_." +msgstr "" + +#: ../../../changes.txt:780 8154a9e3e0e84234937bfd123edc64fe +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:781 37db1f40653548959ab6bcd5742d7889 +msgid "" +"**Added** getting and setting color and text properties for Table of " +"Contents items for PDFs. Implements `#779 " +"`_." +msgstr "" + +#: ../../../changes.txt:782 19a9c7eb168748b299500715808db9ff +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:787 5752d3b6f9de45c393dd7b921adb7981 +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:792 9d53aaa54abe4f7e85cb3346ecbbd9df +msgid "**Changes in Version 1.18.5**" +msgstr "" + +#: ../../../changes.txt:794 98db69d193ac450ea7bbb1e6e3f8f19b +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:796 b339e0699688477ab155d67cdbcb6522 +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:798 d2a198d679754f35aedc7c7b7066daae +msgid "" +"**Fixed** issue `#771 `_. " +"By using \"small glyph heights\" option, the full page text can be " +"extracted." +msgstr "" + +#: ../../../changes.txt:799 a371b119c6a748dfb3bced23e32e56b8 +msgid "**Fixed** issue `#768 `_." +msgstr "" + +#: ../../../changes.txt:800 813e3635a14245839cfac26f7beb62e0 +msgid "**Fixed** issue `#750 `_." +msgstr "" + +#: ../../../changes.txt:801 61ce01475fab415392130c8e958e9ad9 +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:802 2134f71e23e045eaa73514113f41504d +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:803 f1ae9b4969574ecda2d1f7ac67405e49 +msgid "**Fixed** issue `#728 `_." +msgstr "" + +#: ../../../changes.txt:804 ea8be3275c784099a50afab965272da4 +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:805 e7a2dc5b2918423f904c67a871439448 +msgid "" +"**Changed** :meth:`Page.getImageBbox` to also compute the bbox if the " +"image is contained in an XObject." +msgstr "" + +#: ../../../changes.txt:806 05f9fb5c45ea44fa88a6ddaa2e3c5ea7 +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:811 dc2396b451bf4565853096b401300650 +msgid "**Changes in Version 1.18.4**" +msgstr "" + +#: ../../../changes.txt:813 a7e04d8f30e940ca847ec66cf8edca2e +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:815 8d57fec5e3d9470f9e52a9ae8abab4a2 +msgid "" +"**Fixed** issue `#727 `_. " +"Freetext annotations now support an uncolored rectangle when " +"``fill_color=None``." +msgstr "" + +#: ../../../changes.txt:816 6dceb08d5dbe41dcaa50a69a7a962074 +msgid "" +"**Fixed** issue `#726 `_. " +"UTF-8 encoding errors are now handled for HTML / XML :meth:`Page.getText`" +" output." +msgstr "" + +#: ../../../changes.txt:817 76fedf48549f43e59ba32d82f56ea6c9 +msgid "" +"**Fixed** issue `#724 `_. " +"Empty values are no longer stored in the PDF /Info metadata dictionary." +msgstr "" + +#: ../../../changes.txt:818 bc1b525254374f4aac5e08fac82ba1fe +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:819 347c38e1232842e5a162ec109c1ae713 +msgid "" +"**Added** :meth:`Document.set_ocmd`, :meth:`Document.get_ocmd` for " +"handling OCMDs." +msgstr "" + +#: ../../../changes.txt:820 9af8e2f41cdc4fe5a5ceb31593198b61 +msgid "**Added** **Optional Content** support for text insertion and drawing." +msgstr "" + +#: ../../../changes.txt:821 1e3859c5f01a40de8662177bb15463fc +msgid "" +"**Added** new method :meth:`Page.deleteWidget`, which deletes a form " +"field from a page. This is analogous to deleting annotations." +msgstr "" + +#: ../../../changes.txt:822 482424a75a764109ab18f96e5defa374 +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:826 c6cacf5c6cb34665b5ffbfd8a93f90ca +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:828 1924ad7831664dc98624906ac18b76a7 +msgid "" +"Old names will remain available to prevent code breaks, but they will no " +"longer be mentioned in the documentation." +msgstr "" + +#: ../../../changes.txt:829 34ca60924c2f47a796349b10a2398ff3 +msgid "" +"New methods and attributes of all classes will be named according to the " +"new standard." +msgstr "" + +#: ../../../changes.txt:833 b24a33d9b70441c79b96b17f211dece1 +msgid "**Changes in Version 1.18.3**" +msgstr "" + +#: ../../../changes.txt:835 a67f16e120024ef18817bb4433b4184b +msgid "" +"As a major new feature, this version introduces support for PDF's " +"**Optional Content** concept." +msgstr "" + +#: ../../../changes.txt:837 32c4921a1b1346cca1b4b3c7ce236698 +msgid "**Fixed** issue `#714 `_." +msgstr "" + +#: ../../../changes.txt:838 626938bbed45408287ecf2a3f5ca0b25 +msgid "**Fixed** issue `#711 `_." +msgstr "" + +#: ../../../changes.txt:839 dc49661893d847e8ac04af955cf87ac8 +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:840 1bdcd0893526489a80f08cf4e879c3bd +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:841 90a9667b21dd441b8e6bf4e06d65ee83 +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:847 2e1bd49d197b4166a8cc8d5b2a360d6b +msgid "**Changes in Version 1.18.2**" +msgstr "" + +#: ../../../changes.txt:849 6799664210604954b2907b7192f948b5 +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:851 f85cdafc0c17453e827a21576967de3d +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:852 340a04b6fa494148a49f4d9ebccf9f9d +msgid "" +"**Added** :attr:`Document.isRepaired`, which is true if the PDF was " +"repaired on open." +msgstr "" + +#: ../../../changes.txt:853 5085bf2b72154afba4ea2f1967c28125 +msgid "" +"**Added** :meth:`Document.setXmlMetadata` which either updates or creates" +" PDF XML metadata. Implements issue `#691 " +"`_." +msgstr "" + +#: ../../../changes.txt:854 234abc1970ce401eaa5caa35b3e984b1 +msgid "**Added** :meth:`Document.getXmlMetadata` returns PDF XML metadata." +msgstr "" + +#: ../../../changes.txt:855 3ba25840294f4fcf8942d41b6e3d4de6 +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:856 c86282f2e3e04e4ab83b517944fe040a +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:857 0f76d9f9981047669f98ec4794b4fdbd +msgid "" +"**Changed** parameter ``hit_max`` in :meth:`Page.searchFor` and " +":meth:`TextPage.search` is now obsolete: methods will return all hits." +msgstr "" + +#: ../../../changes.txt:858 3896b724dd3946ecba6436e922d0c161 +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:859 04bad261082643408df28affd0d28432 +msgid "" +"**Changed** :meth:`Document.scrub` to support a new option " +"`redact_images`. This addresses issue `#697 " +"`_." +msgstr "" + +#: ../../../changes.txt:864 44bf385455cc42be86376bc2391e01be +msgid "**Changes in Version 1.18.1**" +msgstr "" + +#: ../../../changes.txt:866 2e13ede317524efba17ae264c42e2f0b +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:867 dfbc94a18c7246b9bf3ceb4f981efbe8 +msgid "**Fixed** issue `#686 `_." +msgstr "" + +#: ../../../changes.txt:868 0248ad55c60a41b3961332d61886b13a +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:869 37621fb8bc304533a1cee2d1f8e15029 +msgid "" +"**Added** new parameter ``mask`` to :meth:`Page.insertImage` for " +"optionally providing an external image mask. Resolves issue `#685 " +"`_." +msgstr "" + +#: ../../../changes.txt:870 1e25cd90f6014ab9a89d3953f140a035 +msgid "" +"**Added** :meth:`Annot.soundGet` for extracting the sound of an audio " +"annotation." +msgstr "" + +#: ../../../changes.txt:874 2ec943214ff84a9aba59eba3bf22b0b0 +msgid "**Changes in Version 1.18.0**" +msgstr "" + +#: ../../../changes.txt:876 095bc25d4b5c495f906a0d253cff8a1a +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:878 858cc32472314939aab1523447070411 +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:880 4c8856a9399f4b0d98975bc33018f44a +msgid "**Fixed** issue `#675 `_." +msgstr "" + +#: ../../../changes.txt:882 aeaece20473c458a8ffe9aecb5a17925 +msgid "" +"Unsuccessful storage allocations should now always lead to exceptions " +"(circumvention of an upstream bug intermittently crashing the " +"interpreter)." +msgstr "" + +#: ../../../changes.txt:883 b6a915e419a7439d99f0ed8af5e3f391 +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:885 956ca5ee04e74b56b295f45705b2684f +msgid "" +"**Fixed** issue `#668 `_. " +"Specification of dashes for PDF drawing insertion should now correctly " +"reflect the PDF spec." +msgstr "" + +#: ../../../changes.txt:886 34d16eed672d4888ac3b2df346108292 +msgid "" +"**Fixed** issue `#669 `_. " +"A major source of memory leakage in :meth:`Page.insert_pdf` has been " +"removed." +msgstr "" + +#: ../../../changes.txt:887 9d4a2100ca864d988a1ced723adf4068 +msgid "" +"**Added** keyword *\"images\"* to :meth:`Page.apply_redactions` for fine-" +"controlling the handling of images." +msgstr "" + +#: ../../../changes.txt:888 ae89befba8ca4821b249ea495b09a4df +msgid "" +"**Added** :meth:`Annot.getText` and :meth:`Annot.getTextbox`, which offer" +" the same functionality as the :ref:`Page` versions." +msgstr "" + +#: ../../../changes.txt:889 76c35e69918c44859e6dc3d1b8932761 +msgid "" +"**Added** key *\"number\"* to the block dictionaries of " +":meth:`Page.getText` / :meth:`Annot.getText` for options \"dict\" and " +"\"rawdict\"." +msgstr "" + +#: ../../../changes.txt:890 b0259db6b5634051b77eb7f41d6391a9 +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:891 60fa44d0a8b94d15a71aecb53ad452f1 +msgid "" +"**Added** convenience functions :meth:`adobe_glyph_names` and " +":meth:`adobe_glyph_unicodes` which return the respective available data." +msgstr "" + +#: ../../../changes.txt:892 a8efb7c231a84e829c657597e5bbf170 +msgid "" +"**Added** :meth:`Page.getDrawings` which returns details of drawing " +"operations on a document page. Works for all document types." +msgstr "" + +#: ../../../changes.txt:893 9a21fbda53b843e98178a99c0b7ed69c +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:894 6a91d17224ea4bd9bd0d62e2c24ddaeb +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:899 082e94652e7c45538f32e32b0e666610 +msgid "**Changes in Version 1.17.7**" +msgstr "" + +#: ../../../changes.txt:901 5129cef85c8f4e1facc873bb8adb405e +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:902 b5ef300c1e08425d8dc6c234c6a00070 +msgid "" +"**Fixed** issue `#645 `_. " +"Pixmap top-left coordinates can be set (again) by their own method, " +":meth:`Pixmap.set_origin`." +msgstr "" + +#: ../../../changes.txt:903 15c0c47d25b6426fa647d3450d922f35 +msgid "" +"**Fixed** issue `#622 `_. " +":meth:`Page.insertImage` again accepts a :data:`rect_like` parameter." +msgstr "" + +#: ../../../changes.txt:904 0b9d8e0ca7bc4778a92cfc87a2ac9692 +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:905 8b10afc6cdb14586948cce23efb39143 +msgid "" +"**Added** an option to :meth:`Document.insert_pdf` which allows " +"displaying progress messages. Adresses `#640 " +"`_." +msgstr "" + +#: ../../../changes.txt:906 4bb49bc99bbf47358f885056af4ecfb4 +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:907 cef0f538f4e34038b10776313aace684 +msgid "" +"**Added** new ``clip`` parameter to :meth:`Page.getText` to simplify and " +"speed up text extraction of page sub areas." +msgstr "" + +#: ../../../changes.txt:908 e65cb79cff5c4ea9ad6b7e4fa7a739b7 +msgid "" +"**Added** :meth:`TextWriter.appendv` to add text in **vertical write " +"mode**. Addresses issue `#653 " +"`_" +msgstr "" + +#: ../../../changes.txt:913 e176d1c154524692bf401fa62c1c188b +msgid "**Changes in Version 1.17.6**" +msgstr "" + +#: ../../../changes.txt:915 ba9c27874fd9447dbf106bc0e3d84ab2 +msgid "**Fixed** issue `#605 `_" +msgstr "" + +#: ../../../changes.txt:916 31a52a381b574d479f5b9d9ea723d4e9 +msgid "" +"**Fixed** issue `#600 `_ " +"-- text should now be correctly positioned also for pages with a CropBox " +"smaller than MediaBox." +msgstr "" + +#: ../../../changes.txt:917 c98a5abc96544eb8ab97e713857e7531 +msgid "" +"**Added** text span dictionary key ``origin`` which contains the lower " +"left coordinate of the first character in that span." +msgstr "" + +#: ../../../changes.txt:918 6f9a193520314e5da7c39e15548bfef4 +msgid "**Added** attribute :attr:`Font.buffer`, a *bytes* copy of the font file." +msgstr "" + +#: ../../../changes.txt:919 eefdd6609f394c688514c1fdb787c232 +msgid "" +"**Added** parameter *sanitize* to :meth:`Page.cleanContents`. Allows " +"switching of sanitization, so only syntax cleaning will be done." +msgstr "" + +#: ../../../changes.txt:923 1a2387105f624031b768cbfa06759e45 +msgid "**Changes in Version 1.17.5**" +msgstr "" + +#: ../../../changes.txt:925 741ecba2a0a94ae2951189270e8eb454 +msgid "" +"**Fixed** issue `#561 `_ " +"-- second go: certain :ref:`TextWriter` usages with many alternating " +"fonts did not work correctly." +msgstr "" + +#: ../../../changes.txt:926 b932e69907ab4a62ad220a6d8f0a3040 +msgid "**Fixed** issue `#566 `_." +msgstr "" + +#: ../../../changes.txt:927 e5c51403932944889b50d9f57e82ec1b +msgid "**Fixed** issue `#568 `_." +msgstr "" + +#: ../../../changes.txt:928 6ae0b8425d12480fb60184660042ca73 +msgid "" +"**Fixed** -- opacity is now correctly taken from the :ref:`TextWriter` " +"object, if not given in :meth:`TextWriter.writeText`." +msgstr "" + +#: ../../../changes.txt:929 156e7081625e44c9ad4d802de9eb1bf3 +msgid "" +"**Added** a new global attribute :attr:`fitz_fontdescriptors`. Contains " +"information about usable fonts from repository `pymupdf-fonts " +"`_." +msgstr "" + +#: ../../../changes.txt:930 6c0b342a4e6447e19588c480715c105d +msgid "" +"**Added** :meth:`Font.valid_codepoints` which returns an array of unicode" +" codepoints for which the font has a glyph." +msgstr "" + +#: ../../../changes.txt:931 a50a68a6ffa849288dfed3f6f6acc494 +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:936 5ba6eff8f86f4460a76bd455351b39af +msgid "**Changes in Version 1.17.4**" +msgstr "" + +#: ../../../changes.txt:938 d818681c9f494f4baee26dafbafe4c58 +msgid "" +"**Fixed** issue `#561 `_. " +"Handling of more than 10 :ref:`Font` objects on one page should now work " +"correctly." +msgstr "" + +#: ../../../changes.txt:939 47237ee605644d1c973af3ca1c73ccf3 +msgid "" +"**Fixed** issue `#562 `_. " +"Annotation pixmaps are no longer derived from the page pixmap, thus " +"avoiding unintended inclusion of page content." +msgstr "" + +#: ../../../changes.txt:940 b316c276bda84d96a7f2994934015cd8 +msgid "" +"**Fixed** issue `#559 `_. " +"This **MuPDF** bug is being temporarily fixed with a pre-version of " +"MuPDF's next release." +msgstr "" + +#: ../../../changes.txt:941 aa3084851275466d8427da8bacbcbe0f +msgid "" +"**Added** utility function :meth:`repair_mono_font` for correcting " +"displayed character spacing for some mono-spaced fonts." +msgstr "" + +#: ../../../changes.txt:942 8a34cda3ee47436abd5e42a90b9d0744 +msgid "" +"**Added** utility method :meth:`Document.need_appearances` for fine-" +"controlling Form PDF behavior. Addresses issue `#563 " +"`_." +msgstr "" + +#: ../../../changes.txt:943 d021bd012c1e4399bf1da24cf6a1168e +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:944 a3c10abe57ab45798607fc3b0908ed39 +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:945 4fc75b886d79461090c645fc457fa2d9 +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:946 02874b4770084f138aa77948194a3202 +msgid "" +"**Added** support for optional fonts in repository `pymupdf-fonts " +"`_." +msgstr "" + +#: ../../../changes.txt:950 f06bde818145499a8e775b3c1cfac7cb +msgid "**Changes in Version 1.17.3**" +msgstr "" + +#: ../../../changes.txt:952 6b40c3bf32aa4e79b612320b87eb3502 +msgid "" +"**Fixed** an undocumented issue, which prevented fully cleaning a PDF " +"page when using :meth:`Page.cleanContents`." +msgstr "" + +#: ../../../changes.txt:953 b275e07ee7b54c078d63045f2d134f2f +msgid "" +"**Fixed** issue `#540 `_. " +"Text extraction for EPUB should again work correctly." +msgstr "" + +#: ../../../changes.txt:954 dca2ad477c63491eb4330196a26029fd +msgid "" +"**Fixed** issue `#548 `_. " +"Documentation now includes ``LINK_NAMED``." +msgstr "" + +#: ../../../changes.txt:955 8e8b80f2ea454ee592e6a7f421afab07 +msgid "" +"**Added** new parameter to control start of text in " +":meth:`TextWriter.fillTextbox`. Implements `#549 " +"`_." +msgstr "" + +#: ../../../changes.txt:956 a925f042226d4acface69b1ba95badfd +msgid "" +"**Changed** documentation of :meth:`Page.add_redact_annot` to explain the" +" usage of non-builtin fonts." +msgstr "" + +#: ../../../changes.txt:960 c35fe24dbf1b406f9b7126a51afd2a9b +msgid "**Changes in Version 1.17.2**" +msgstr "" + +#: ../../../changes.txt:962 0903122502864bf882572b1922c52cb4 +msgid "**Fixed** issue `#533 `_." +msgstr "" + +#: ../../../changes.txt:963 92055f4a9d75446885b491acec0043f8 +msgid "" +"**Added** options to modify 'Redact' annotation appearance. Implements " +"`#535 `_." +msgstr "" + +#: ../../../changes.txt:968 1ef40850620449a4857d31eefbc88eec +msgid "**Changes in Version 1.17.1**" +msgstr "" + +#: ../../../changes.txt:970 ce43a02e279543458d785f9fc73f13f1 +msgid "**Fixed** issue `#520 `_." +msgstr "" + +#: ../../../changes.txt:971 bf33597e291a46d0879407f809eb36af +msgid "" +"**Fixed** issue `#525 `_. " +"Vertices for 'Ink' annots should now be correct." +msgstr "" + +#: ../../../changes.txt:972 5c57661c77cd482d905247a045149b73 +msgid "" +"**Fixed** issue `#524 `_. " +"It is now possible to query and set rotation for applicable annotation " +"types." +msgstr "" + +#: ../../../changes.txt:974 b7884a7686a842878cd2b8b3f3857960 +msgid "" +"Also significantly improved inline documentation for better support of " +"interactive help." +msgstr "" + +#: ../../../changes.txt:978 806f6264c53145cb8ba026490042f90f +msgid "**Changes in Version 1.17.0**" +msgstr "" + +#: ../../../changes.txt:980 cf55a235c1454325943e04b102932223 +msgid "" +"This version is based on MuPDF v1.17. Following are highlights of new and" +" changed features:" +msgstr "" + +#: ../../../changes.txt:982 9a884945fa3641d79cc4ff154c046d92 +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:984 6fcc4e3bbdd94d24b8d869fece2c4b00 +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:986 1931ec870842464faade2b797b1ad89e +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:990 cf4e520c746f4c0eadd89b7749a39b75 +msgid "" +"**Changed** :meth:`TextWriter.writeText` to support the *\"morph\"* " +"parameter." +msgstr "" + +#: ../../../changes.txt:991 639b8f5d0fb24c99b0684df7291a8528 +msgid "" +"**Added** methods :meth:`Rect.morph`, :meth:`IRect.morph`, and " +":meth:`Quad.morph`, which return a new :ref:`Quad`." +msgstr "" + +#: ../../../changes.txt:992 288b1e51319d4f53aeda9ea7eb198367 +msgid "" +"**Changed** :meth:`Page.add_freetext_annot` to support text alignment via" +" a new *\"align\"* parameter." +msgstr "" + +#: ../../../changes.txt:993 8c4679875f694a6297faaedd64a83060 +msgid "" +"**Fixed** issue `#508 `_. " +"Improved image rectangle calculation to hopefully deliver correct values " +"in most if not all cases." +msgstr "" + +#: ../../../changes.txt:994 d6216148fabb460aae9403c191a3f898 +msgid "**Fixed** issue `#502 `_." +msgstr "" + +#: ../../../changes.txt:995 d4df0b007bfe44b3a30c61c26ad62d7f +msgid "" +"**Fixed** issue `#500 `_. " +":meth:`Document.convertToPDF` should no longer cause memory leaks." +msgstr "" + +#: ../../../changes.txt:996 27c2e942a01f475ab4147329df2b178c +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:997 711e867dce8041948ea49f3069b290e5 +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:999 27fe78fba677457396ccdc11d594f076 +msgid "Potential code breaking changes:" +msgstr "" + +#: ../../../changes.txt:1001 3f80a4a143dc46b0b59353a44cd0ee4b +msgid "" +"The private method ``Page._getTransformation()`` has been removed. Use " +"the public :attr:`Page.transformationMattrix` instead." +msgstr "" + +#: ../../../changes.txt:1006 bf7fbfb16ec94824a53baf9a99a429be +msgid "**Changes in Version 1.16.18**" +msgstr "" + +#: ../../../changes.txt:1008 fa13cfec350d4c3bb0c7213e2bdb2208 +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:1010 b93600514dc2497db35dc4a71bbb0c8e +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:1012 877630e4ce4140cc80092ea012460e26 +msgid "" +"**Fixed** issue `#493 `_. " +"``Pixmap(doc, xref)`` should now again correctly resemble the loaded " +"image object." +msgstr "" + +#: ../../../changes.txt:1013 7d869b5af1fd4104a1efa1c311bf3d12 +msgid "" +"**Fixed** issue `#488 `_. " +"Widget names are now modifiable." +msgstr "" + +#: ../../../changes.txt:1014 c5a3725f12a64e7ea54783c1012a4da5 +msgid "**Added** new class :ref:`Font` which represents a font." +msgstr "" + +#: ../../../changes.txt:1015 9b1939cc14d84b33a73af14708f8b3e9 +msgid "" +"**Added** new class :ref:`TextWriter` which serves as a container for " +"text to be written on a page." +msgstr "" + +#: ../../../changes.txt:1016 7f3f09c4f820459ea8a7ca162e24053e +msgid "" +"**Added** :meth:`Page.writeText` to write one or more :ref:`TextWriter` " +"objects to the page." +msgstr "" + +#: ../../../changes.txt:1021 695779e47a2741f9bdf464e9671d8fe6 +msgid "**Changes in Version 1.16.17**" +msgstr "" + +#: ../../../changes.txt:1024 2412df72b1dc488aa41e6f6f42c4bcd8 +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:1025 f0ad67327a394fd288fa95d488c0edaa +msgid "" +"**Added** :meth:`Pixmap.set_dpi` which sets the image resolution in x and" +" y directions." +msgstr "" + +#: ../../../changes.txt:1029 6c777ff9e4684caf9803b08dd0dd0bd1 +msgid "**Changes in Version 1.16.16**" +msgstr "" + +#: ../../../changes.txt:1032 b60d58dc72f6465480f70028459bea67 +msgid "**Fixed** issue `#477 `_." +msgstr "" + +#: ../../../changes.txt:1033 b04507c2cb5a489a99d825d8d002ea74 +msgid "**Fixed** issue `#476 `_." +msgstr "" + +#: ../../../changes.txt:1034 c1bf12348ef640bf874fc5c74610d424 +msgid "" +"**Changed** annotation line end symbol coloring and fixed an error " +"coloring the interior of 'Polyline' /'Polygon' annotations." +msgstr "" + +#: ../../../changes.txt:1038 31857962c1514fa686a6eac52668e5e2 +msgid "**Changes in Version 1.16.14**" +msgstr "" + +#: ../../../changes.txt:1041 504439d16cc84d8d8ee69dfce9e3deb3 +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:1043 0b0b50de1287431587c02019953f1c01 +msgid "" +"**Added** :meth:`Document.scrub` which **removes potentially sensitive " +"data** from a PDF. Implements `#453 " +"`_." +msgstr "" + +#: ../../../changes.txt:1045 f61d00e917bf488f99b6717b3e8b5dc2 +msgid "" +"**Added** :meth:`Annot.blendMode` which returns the **blend mode** of " +"annotations." +msgstr "" + +#: ../../../changes.txt:1047 1188b17144b34cc981f00fd4a302ca3e +msgid "" +"**Added** :meth:`Annot.setBlendMode` to set the annotation's blend mode. " +"This resolves issue `#416 " +"`_." +msgstr "" + +#: ../../../changes.txt:1048 53bc704437d24552aa3cb2006855f6b4 +msgid "" +"**Changed** :meth:`Annot.update` to accept additional parameters for " +"setting blend mode and opacity." +msgstr "" + +#: ../../../changes.txt:1049 f764246d636f432492c0aa0e81eb12f0 +msgid "" +"**Added** advanced graphics features to **control the anti-aliasing " +"values**, :meth:`Tools.set_aa_level`. Resolves `#467 " +"`_" +msgstr "" + +#: ../../../changes.txt:1051 04fb6e3ddc5d4296bfd8b3058545b35a +msgid "**Fixed** issue `#474 `_." +msgstr "" + +#: ../../../changes.txt:1052 f921a3e4c14c46d98e1f7461a570c5a5 +msgid "**Fixed** issue `#466 `_." +msgstr "" + +#: ../../../changes.txt:1058 7d88d00aa64f4600be70cf6993ea6a8f +msgid "**Changes in Version 1.16.13**" +msgstr "" + +#: ../../../changes.txt:1061 b88c40ce51f14e5aab0c43f48a7a7d95 +msgid "" +"**Added** :meth:`Document.getPageXObjectList` which returns a list of " +"**Form XObjects** of the page." +msgstr "" + +#: ../../../changes.txt:1062 da40841b55c54b28a79786a5d3ffa397 +msgid "" +"**Added** :meth:`Page.setMediaBox` for changing the physical PDF page " +"size." +msgstr "" + +#: ../../../changes.txt:1063 17507d37eb274d34bd060e0708cb5472 +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:1069 4fc5d96d0deb4a9cbe59bb29b7e68570 +msgid "**Changes in Version 1.16.12**" +msgstr "" + +#: ../../../changes.txt:1071 cc24493ae0a54545a81f17c68eb29e9d +msgid "**Fixed** issue `#447 `_" +msgstr "" + +#: ../../../changes.txt:1072 7579e73e78a84625bfe6ee3792302670 +msgid "**Fixed** issue `#461 `_." +msgstr "" + +#: ../../../changes.txt:1073 85c76d4339a847c798a9eae894eedbb7 +msgid "**Fixed** issue `#397 `_." +msgstr "" + +#: ../../../changes.txt:1074 e6bf33dfa08346458f3f4d1484f9842a +msgid "**Fixed** issue `#463 `_." +msgstr "" + +#: ../../../changes.txt:1075 1c789b83d9d34092ad2102ebf9d22905 +msgid "" +"**Added** JavaScript support to PDF form fields, thereby fixing `#454 " +"`_." +msgstr "" + +#: ../../../changes.txt:1076 6a3f42bb1006499888f52a084e10208b +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:1077 2d7c9a5d418d463db626b1d3b9748d98 +msgid "" +"**Added** a new form field method :meth:`Widget.reset`, which resets the " +"field value to its default." +msgstr "" + +#: ../../../changes.txt:1078 261342e399ea464ca8fec28a284ee326 +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:1082 d7fd4eac70b24e8dbfb004e1aa92390d +msgid "**Changes in Version 1.16.11**" +msgstr "" + +#: ../../../changes.txt:1084 0822760b58694d96b7159931ca7258d4 +msgid "" +"**Added** Support for redaction annotations via method " +":meth:`Page.add_redact_annot` and :meth:`Page.apply_redactions`." +msgstr "" + +#: ../../../changes.txt:1085 c2d9af0dc8414766b71f3e383861824d +msgid "**Fixed** issue #426 (\"PolygonAnnotation in 1.16.10 version\")." +msgstr "" + +#: ../../../changes.txt:1086 92f1412f2ed649638393a1c403a1798f +msgid "" +"**Fixed** documentation only issues `#443 " +"`_ and `#444 " +"`_." +msgstr "" + +#: ../../../changes.txt:1090 24a04cade8294542beec28ff275a0bce +msgid "**Changes in Version 1.16.10**" +msgstr "" + +#: ../../../changes.txt:1092 52595d50123242d590b5a44492287492 +msgid "" +"**Fixed** issue #421 (\"annot.set_rect(rect) has no effect on text " +"Annotation\")" +msgstr "" + +#: ../../../changes.txt:1093 5299cb18e4a94f77a7c2899c60482581 +msgid "" +"**Fixed** issue #417 (\"Strange behavior for page.deleteAnnot on 1.16.9 " +"compare to 1.13.20\")" +msgstr "" + +#: ../../../changes.txt:1094 27221435083840ed93886547c1b7f0c3 +msgid "**Fixed** issue #415 (\"Annot.setOpacity throws mupdf warnings\")" +msgstr "" + +#: ../../../changes.txt:1095 66be50e113ee4337a7525d78a29c4076 +msgid "" +"**Changed** all \"add annotation / widget\" methods to store a unique " +"name in the */NM* PDF key." +msgstr "" + +#: ../../../changes.txt:1096 d4649e05b4d54dab9bc42997206ee07d +msgid "" +"**Changed** :meth:`Annot.setInfo` to also accept direct parameters in " +"addition to a dictionary." +msgstr "" + +#: ../../../changes.txt:1097 01b3db1cd65e4b3e89474ef2e288cff5 +msgid "" +"**Changed** :attr:`Annot.info` to now also show the annotation's unique " +"id (*/NM* PDF key) if present." +msgstr "" + +#: ../../../changes.txt:1098 13e37f6a4fc44e44be340ec845e99c80 +msgid "" +"**Added** :meth:`Page.annot_names` which returns a list of all annotation" +" names (*/NM* keys)." +msgstr "" + +#: ../../../changes.txt:1099 26db226a53f64a6b838ec10031bd266e +msgid "" +"**Added** :meth:`Page.load_annot` which loads an annotation given its " +"unique id (*/NM* key)." +msgstr "" + +#: ../../../changes.txt:1100 e0e399bb1d8b4f2a84f06464910e6b14 +msgid "" +"**Added** :meth:`Document.reload_page` which provides a new copy of a " +"page after finishing any pending updates to it." +msgstr "" + +#: ../../../changes.txt:1105 aed5b308b17243e9b8b3ed97324588d8 +msgid "**Changes in Version 1.16.9**" +msgstr "" + +#: ../../../changes.txt:1107 af5cc7726fdd46258c40bca54d82edb8 +msgid "" +"**Fixed** #412 (\"Feature Request: Allow controlling whether TOC entries " +"should be collapsed\")" +msgstr "" + +#: ../../../changes.txt:1108 9397e6816fc64f4295109a476785b783 +msgid "**Fixed** #411 (\"Seg Fault with page.firstWidget\")" +msgstr "" + +#: ../../../changes.txt:1109 1b4ae8d131864c1f92bea6ba0ccd3a4a +msgid "**Fixed** #407 (\"Annot.setOpacity trouble\")" +msgstr "" + +#: ../../../changes.txt:1110 710a8a09863b45eb9b799b3ef3976df9 +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:1114 5a145dd639424152b92039d9feebf030 +msgid "**Changes in Version 1.16.8**" +msgstr "" + +#: ../../../changes.txt:1116 9780b8b5b17d4acaa276d90c35f1976d +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:1117 c9c0ece0d68d41deaaa10b90254e1034 +msgid "" +"**Added** :meth:`Tools.mupdf_disply_errors` which sets the display of " +"mupdf errors on *sys.stderr*." +msgstr "" + +#: ../../../changes.txt:1118 4640a74eccc04dd5a8e4b4eb901a34b6 +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:1123 28c4c9da0497431da3ff34a0468067ef +msgid "**Changes in Version 1.16.7**" +msgstr "" + +#: ../../../changes.txt:1125 c421a663f8644fb3bad6e0a02892f560 +msgid "" +"Minor changes to better synchronize the binary image streams of " +":ref:`TextPage` image blocks and :meth:`Document.extractImage` images." +msgstr "" + +#: ../../../changes.txt:1127 af2d616cd4a84811b074432eb8a4f9a5 +msgid "" +"**Fixed** issue #394 (\"PyMuPDF Segfaults when using " +"TOOLS.mupdf_warnings()\")." +msgstr "" + +#: ../../../changes.txt:1128 e2258df8dd5b4f818d2314dd1008b5cb +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:1129 d55570634f054d5a817df48eba76b249 +msgid "" +"**Changed** :meth:`Tools.mupdf_warnings` to automatically empty the store" +" (if not deactivated via a parameter)." +msgstr "" + +#: ../../../changes.txt:1130 7b1bfde2cccc4709b160493ba250f22b +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:1135 3555f1b80b6a400c97822cbaf2b31838 +msgid "**Changes in Version 1.16.6**" +msgstr "" + +#: ../../../changes.txt:1137 f7f268a4c4a54923894c64900cd8028e +msgid "**Fixed** issue #390 (\"Incomplete deletion of annotations\")." +msgstr "" + +#: ../../../changes.txt:1138 065a86a8d2da416d8d04ae0747fa7d3b +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:1139 fff132f168fc4072beb8eb7593d799c4 +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:1143 de7cd53c3dd84c81922546c9a6b046c5 +msgid "**Changes in Version 1.16.5**" +msgstr "" + +#: ../../../changes.txt:1145 f1fb32b721b54ba48fc26b570789edef +msgid "More performance improvements for text extraction." +msgstr "" + +#: ../../../changes.txt:1147 740a6a66dba24c349ecf903f987353e3 +msgid "**Fixed** second part of issue #381 (see item in v1.16.4)." +msgstr "" + +#: ../../../changes.txt:1148 1526a76a24cb47f0873b9ef71b2dd1a0 +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:1152 eb0b448a27dc49938f44f446b81a4a4a +msgid "**Changes in Version 1.16.4**" +msgstr "" + +#: ../../../changes.txt:1155 d8c289a747704fbbb42d7cc7729d6bb7 +msgid "" +"**Fixed** issue #381 (\"TextPage.extractDICT ... failed ... after " +"upgrading ... to 1.16.3\")" +msgstr "" + +#: ../../../changes.txt:1156 223db25f4a2540518c91a0c249124a62 +msgid "" +"**Added** method :meth:`Document.pages` which delivers a generator " +"iterator over a page range." +msgstr "" + +#: ../../../changes.txt:1157 a7abcf8b19f44b2490885c07666cfa2b +msgid "" +"**Added** method :meth:`Page.links` which delivers a generator iterator " +"over the links of a page." +msgstr "" + +#: ../../../changes.txt:1158 10f3e08eab264528b3d3db39ba9956ab +msgid "" +"**Added** method :meth:`Page.annots` which delivers a generator iterator " +"over the annotations of a page." +msgstr "" + +#: ../../../changes.txt:1159 2e4346ce0a8b42d3869f605054a586e6 +msgid "" +"**Added** method :meth:`Page.widgets` which delivers a generator iterator" +" over the form fields of a page." +msgstr "" + +#: ../../../changes.txt:1160 1ec27ea8b02a432a88ed2a21a27c0de0 +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:1165 7551a058966e4a94bba10baa299331b2 +msgid "**Changes in Version 1.16.3**" +msgstr "" + +#: ../../../changes.txt:1167 a0b2035db5a44c89b2fcae3a56a2ee95 +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:1169 2bf1cc9db4ab4ebcb547173f31bc7517 +msgid "" +"**Fixed** issue #369 (\"mupdf: cmsCreateTransform failed\") by removing " +"ICC colorspace support." +msgstr "" + +#: ../../../changes.txt:1170 fbdad47308f0413c99ef50cc29655e87 +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:1171 36c87a67f47241e78b4f51e765e74117 +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:1175 baf13d988a7a4a848642180b419f52e9 +msgid "**Changes in Version 1.16.2**" +msgstr "" + +#: ../../../changes.txt:1177 d0b6206151024675b9aedc333be895d8 +msgid "" +"**Changed** text extraction methods of :ref:`Page` to allow detail " +"control of the amount of extracted data." +msgstr "" + +#: ../../../changes.txt:1178 61ab8025a15141c787f750bf270e7035 +msgid "" +"**Added** :meth:`planish_line` which maps a given line (defined as a pair" +" of points) to the x-axis." +msgstr "" + +#: ../../../changes.txt:1179 75a290ed727e4397a3da6742d2e22d7f +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:1180 49a69ff398334033a0f449e3d6d41bd3 +msgid "**Fixed** issue #362 (\"Memory Leak with getText('rawDICT')\")." +msgstr "" + +#: ../../../changes.txt:1184 0f5bbb32c11a44a8806c55e10ca8673f +msgid "**Changes in Version 1.16.1**" +msgstr "" + +#: ../../../changes.txt:1186 83069d2bccf44862a33c7db761ae6578 +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:1187 2f2fdcc0963a4ed5a3c64fefdb971dd7 +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:1188 dcdae227b64e4a3d84bb402c9312813c +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:1189 ea6d6d3b57024ffc9ae55d49deca377c +msgid "" +"**Fixed** issue #354 (\"SyntaxWarning with Python 3.8\"). We now always " +"use *\"==\"* for literals (instead of the *\"is\"* Python keyword)." +msgstr "" + +#: ../../../changes.txt:1190 db17531c5154475e8582db5c09691fba +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:1196 48d922134df04ec49d3a643f054b6e23 +msgid "**Changes in Version 1.16.0**" +msgstr "" + +#: ../../../changes.txt:1198 3f1ccd856d5743f4bca20c93cda4bd41 +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:1200 d392ecad7d2c4c1eba7b56b3a6a74adb +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:1201 d3d8796873434be4b1370d90a75c6f25 +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:1202 d7af11f1d3b84d0ea2b8992ff63e46d1 +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:1203 c3ad397a38824b01a31037dc54c5e576 +msgid "Annotations are now **only supported for PDF**." +msgstr "" + +#: ../../../changes.txt:1204 13d1003a83c44220862e6a67b64f1eb7 +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:1205 19d94710dfef472e9738a742b58a11f4 +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:1207 f85309a38f9445eab6ba9021b74117f0 +msgid "List of change details:" +msgstr "" + +#: ../../../changes.txt:1209 e40301de93864cd0ab5711fb55fda34e +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:1210 08a9518e01ee462a9a5e8c47fdfd8731 +msgid "" +"**Added** :attr:`Page.firstWidget` which points to the first field on a " +"page." +msgstr "" + +#: ../../../changes.txt:1211 a317291df3fa410587625c221121a92a +msgid "" +"**Added** :meth:`Page.getImageBbox` which returns the rectangle occupied " +"by an image shown on the page." +msgstr "" + +#: ../../../changes.txt:1212 f7a4a9ec45f94ded827762fe47d2d803 +msgid "" +"**Added** :meth:`Annot.setName` which lets you change the (icon) name " +"field." +msgstr "" + +#: ../../../changes.txt:1213 3046934a33a0452a9c2c47975904a056 +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:1214 0f42f7831bf741a3a1c672b250f18db0 +msgid "" +"**Changed** :attr:`Document.permissions` to now contain an integer of " +"bool indicators -- was a dictionary before." +msgstr "" + +#: ../../../changes.txt:1215 780094f609df4a00a79c001fd9a0902f +msgid "" +"**Changed** :meth:`Document.save`, :meth:`Document.write`, which now " +"fully support password-based decryption and encryption of PDF files." +msgstr "" + +#: ../../../changes.txt:1216 60f3748e1c564eaf8e9712fd5575a422 +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:1217 45b467d3b951491588c8581cb37a62bd +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:1218 6864b218b42c40aaa741df6f9a06ba2f +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:1219 efd40cefb6834ad3b9d7f794420d376e +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:1220 127ddffd84ed494bb2cbf836ac9ee3ce +msgid "" +"**Changed** :meth:`Page.add_file_annot` and :meth:`Page.add_text_annot` " +"to enable setting an icon." +msgstr "" + +#: ../../../changes.txt:1221 d95b9a7875644af58f5b24848d34076f +msgid "" +"**Removed** widget-related methods and attributes from the :ref:`Annot` " +"object." +msgstr "" + +#: ../../../changes.txt:1222 c298f7c2629240b8aec90ebe27fb3070 +msgid "" +"**Removed** :ref:`Document` attributes *openErrCode*, *openErrMsg*, and " +":ref:`Tools` attributes / methods *stderr*, *reset_stderr*, *stdout*, and" +" *reset_stdout*." +msgstr "" + +#: ../../../changes.txt:1223 6ffe06a3ddff46259ff75a8a184d2ea3 +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:1225 0520e9c0542c4cdb89828f6d508b9ca4 +msgid "**No version published for MuPDF v1.15.0**" +msgstr "" + +#: ../../../changes.txt:1230 01dc6b02eab4471b8c2de49b9470bd03 +msgid "**Changes in Version 1.14.20 / 1.14.21**" +msgstr "" + +#: ../../../changes.txt:1232 9ff5baca996c4ccdb21e5a927c8baf4a +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:1233 28dfc3da46454cf9ac9b8d93e400cc28 +msgid "" +"**Fixed** issue #331 (\"Importing PyMuPDF changes warning filtering " +"behaviour globally\")." +msgstr "" + +#: ../../../changes.txt:1238 4fae70e99e704ebf9b4588e1feced0ef +msgid "**Changes in Version 1.14.19**" +msgstr "" + +#: ../../../changes.txt:1240 01c7bba0f0474e7aa17e0fed9f29dadd +msgid "**Fixed** issue #319 (\"InsertText function error when use custom font\")." +msgstr "" + +#: ../../../changes.txt:1241 5192a4da6a8044e59156a91d5d9d6a8c +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:1246 0d40df3fd34e498da39e776636581f38 +msgid "**Changes in Version 1.14.17**" +msgstr "" + +#: ../../../changes.txt:1248 4b8f4bd9a6fc4732b975e698b107a052 +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:1249 acf758bf47f64ef5a4956b5ecdf91dd0 +msgid "" +"**Changed** :meth:`Page.getPixmap`, :meth:`Document.get_page_pixmap` now " +"use *alpha=False* as default." +msgstr "" + +#: ../../../changes.txt:1250 636a1f4308ad4d228ef93c34feeb7012 +msgid "" +"**Changed** text extraction: the span dictionary now (again) contains its" +" rectangle under the *bbox* key." +msgstr "" + +#: ../../../changes.txt:1251 d9cf48791e3d4263b8f6a6c0e7e150b3 +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:1255 895458c4ca7e41428ce4e3e714b1c744 +msgid "**Changes in Version 1.14.16**" +msgstr "" + +#: ../../../changes.txt:1257 1eb848f8d55f4bb99666635729724cc4 +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:1258 156bd4b98a5c44cb96c611a08bb8f427 +msgid "" +"**Changed** :meth:`Document.embfile_Count` to be a function (was an " +"attribute)." +msgstr "" + +#: ../../../changes.txt:1259 3d9bd1b4d6d9410ca95bc6ab621fd3df +msgid "" +"**Added** new method :meth:`Document.embfile_Names` which returns a list " +"of names of embedded files." +msgstr "" + +#: ../../../changes.txt:1260 beb2b16c79924073a0f543bdc0ee3cd2 +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:1265 9f471f1b08744dfda650a5da5dacb907 +msgid "**Changes in Version 1.14.15**" +msgstr "" + +#: ../../../changes.txt:1267 919992667bc34e5fa58ea9ac06fe1044 +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:1268 96560eadbdd0413181cb00fdb6cdbcb2 +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:1273 cd21fd5acbd941348129bf5f6e94658a +msgid "**Changes in Version 1.14.14**" +msgstr "" + +#: ../../../changes.txt:1275 3e9441ff527a4659b7329b9c1848fcf9 +msgid "" +"**Added** new low-level function :meth:`ImageProperties` to determine a " +"number of characteristics for an image." +msgstr "" + +#: ../../../changes.txt:1276 1dca3a1224bb4d1589bc4b45af88a37f +msgid "" +"**Added** new low-level function :meth:`Document.is_stream`, which checks" +" whether an object is of stream type." +msgstr "" + +#: ../../../changes.txt:1277 b3510f482a33437a965a5a36e148b6eb +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:1281 74d3d08fe1204dd4a996c9cf581516d9 +msgid "**Changes in Version 1.14.13**" +msgstr "" + +#: ../../../changes.txt:1283 459bf96c8fb844e597ca8f9b85e5e493 +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:1284 7f45abca50d1473fa56e1512f6bb0db1 +msgid "" +"**Fixed** issue #278 (\"Is insertImage(keep_proportion=True) broken?\"). " +"Images are now correctly presented when keeping aspect ratio." +msgstr "" + +#: ../../../changes.txt:1289 06285c0366884de6911d2794cc3bb456 +msgid "**Changes in Version 1.14.12**" +msgstr "" + +#: ../../../changes.txt:1291 248c9ea32a8e44bbbd0595c1ca8b0749 +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:1292 73e5c107c9bc4829af7658fa77a35027 +msgid "" +"**Fixed** issue #269 (\"AttributeError in Document.insert_page()\"), " +"which occurred when using :meth:`Document.insert_page` with text " +"insertion." +msgstr "" + +#: ../../../changes.txt:1297 21be84637a2e44c48989b10bdf6659ad +msgid "**Changes in Version 1.14.11**" +msgstr "" + +#: ../../../changes.txt:1299 7c55c26b35124b52aadfb1e4c6e41c59 +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:1300 dc19219032fa4070bc6a1c3b40b5d58c +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:1301 88f67b1ce0a94a42875737fa93117426 +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:1305 b881374064c043ebb415ab8c8d1db2b7 +msgid "**Changes in Version 1.14.10**" +msgstr "" + +#: ../../../changes.txt:1307 6b994edd40d14687b9069ee06cea70a2 +msgid "" +"**Changed** :meth:`Page.show_pdf_page` to support rotation of the source " +"rectangle. Fixes #261 (\"Cannot rotate insterted pages\")." +msgstr "" + +#: ../../../changes.txt:1308 a1ce637fb07c42b1814bbebbebada296 +msgid "" +"**Fixed** a bug in :meth:`Page.insertImage` which prevented insertion of " +"multiple images provided as streams." +msgstr "" + +#: ../../../changes.txt:1313 f92b3e7d83244d218143e7b2e4b87a77 +msgid "**Changes in Version 1.14.9**" +msgstr "" + +#: ../../../changes.txt:1315 6fc5533855d84528880df28a0e22f5ef +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:1316 af5411c9f7bf48f2bdb08c365fb758c1 +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:1317 c76f57d76d3b4dc8bce5567e2ce4c762 +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:1318 7175f972ea16471abf3edaf56e3227ef +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:1322 468346b96864476dbc3523135f8e5952 +msgid "**Changes in Version 1.14.8**" +msgstr "" + +#: ../../../changes.txt:1324 8cd7f87ea9a3492da635ae82e6f61917 +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:1325 0d579d5ce50648ab9e396d4859ba5834 +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:1326 97bd2cc0329d47f7bad8eb59f63a1097 +msgid "" +"**Fixed** an issue with not correctly clearing a non-alpha :ref:`Pixmap` " +"(:meth:`Pixmap.clear_with`)." +msgstr "" + +#: ../../../changes.txt:1327 6492f2b5472748aebc369939fb046147 +msgid "" +"**Fixed** an issue with not correctly inverting colors of a non-alpha " +":ref:`Pixmap` (:meth:`Pixmap.invert_irect`)." +msgstr "" + +#: ../../../changes.txt:1331 bbb58b30fbd3456ba8759ca4f4efa172 +msgid "**Changes in Version 1.14.7**" +msgstr "" + +#: ../../../changes.txt:1333 eb52e3594b1649a1aef4509d9f1f4f4a +msgid "**Added** :meth:`Pixmap.set_pixel` to change one pixel value." +msgstr "" + +#: ../../../changes.txt:1334 69f7cab9f92e4876bbfa640012ef1ab4 +msgid "**Added** documentation for image conversion in the :ref:`FAQ`." +msgstr "" + +#: ../../../changes.txt:1335 45f95f0143e144068ba73c24db5cffe6 +msgid "" +"**Added** new function :meth:`get_text_length` to determine the string " +"length for a given font." +msgstr "" + +#: ../../../changes.txt:1336 ab6193d5c8754da8aea900dd61af7e77 +msgid "" +"**Added** Postscript image output (changed :meth:`Pixmap.save` and " +":meth:`Pixmap.tobytes`)." +msgstr "" + +#: ../../../changes.txt:1337 9789070989834dd596af4491071e7efd +msgid "" +"**Changed** :meth:`Pixmap.save` and :meth:`Pixmap.tobytes` to ensure " +"valid combinations of colorspace, alpha and output format." +msgstr "" + +#: ../../../changes.txt:1338 620f8a1d5b0a4984bc84aba1acdc41b7 +msgid "" +"**Changed** :meth:`Pixmap.save`: the desired format is now inferred from " +"the filename." +msgstr "" + +#: ../../../changes.txt:1339 12a5d4c4064b4f6382404635b8cb2765 +msgid "" +"**Changed** FreeText annotations can now have a transparent background - " +"see :meth:`Annot.update`." +msgstr "" + +#: ../../../changes.txt:1343 08c4041247364c148fbe5fd5339eb3bf +msgid "**Changes in Version 1.14.5**" +msgstr "" + +#: ../../../changes.txt:1345 881dab3054b24c78b9c413b6b5d6fc90 +msgid "" +"**Changed:** :ref:`Shape` methods now strictly use the transformation " +"matrix of the :ref:`Page` -- instead of \"manually\" calculating " +"locations." +msgstr "" + +#: ../../../changes.txt:1346 2e98be2e6e0b4b6a8816c04be3bb7042 +msgid "" +"**Added** method :meth:`Pixmap.pixel` which returns the pixel value (a " +"list) for given pixel coordinates." +msgstr "" + +#: ../../../changes.txt:1347 4956b1197af943d5b9a0d8bc8237caaa +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:1348 f73310317bcc496cbd35295a1a069482 +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:1349 cdf478e5cf724f7bb1f4e3b7fdb6105d +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:1350 fffe3a8be2384100905fc0fe938dfb8e +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:1354 4f1c7310e6714e5db397c5824788cfd7 +msgid "**Changes in Version 1.14.4**" +msgstr "" + +#: ../../../changes.txt:1356 6d1e55290b4e4f6390001ef39a512e33 +msgid "**Fixes** issue #239 \"Annotation coordinate consistency\"." +msgstr "" + +#: ../../../changes.txt:1361 4661418d68704e4a9d277fc8c24ce350 +msgid "**Changes in Version 1.14.3**" +msgstr "" + +#: ../../../changes.txt:1363 9594ef01d13c4c2bb4fb165983e52a09 +msgid "This patch version contains minor bug fixes and CJK font output support." +msgstr "" + +#: ../../../changes.txt:1365 fa8eb977f17a43fcb85120c19be904ef +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:1366 14e1a329119c45dc8076654e259646e3 +msgid "**Added** full support for the built-in fonts 'Symbol' and 'Zapfdingbats'." +msgstr "" + +#: ../../../changes.txt:1367 1bd4bb95b4dc4f87ae46fc0e3432bdbb +msgid "" +"**Changed:** The 14 standard fonts can now each be referenced by a " +"4-letter abbreviation." +msgstr "" + +#: ../../../changes.txt:1371 9a5f0711a4084ee3bf40fc747e14afa7 +msgid "**Changes in Version 1.14.1**" +msgstr "" + +#: ../../../changes.txt:1373 7d5391f59093466797203b5f42d73b36 +msgid "This patch version contains minor performance improvements." +msgstr "" + +#: ../../../changes.txt:1375 05d3a003033f4c17a9e911c7052bd98c +msgid "" +"**Added** support for :ref:`Document` filenames given as *pathlib* object" +" by using the Python *str()* function." +msgstr "" + +#: ../../../changes.txt:1380 dc4e5f9e97454783b473d71a7df60b24 +msgid "**Changes in Version 1.14.0**" +msgstr "" + +#: ../../../changes.txt:1382 b4e584566dea4f3f9d447b551cc05e3a +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:1384 1a42730abb044198bc63bd7432f8f6f9 +msgid "**Added** \"ink\" annotation." +msgstr "" + +#: ../../../changes.txt:1385 5b58cc51d4714412aca956fb7001dbcf +msgid "**Added** \"rubber stamp\" annotation." +msgstr "" + +#: ../../../changes.txt:1386 0ee5b2610625419ea9292f4e1e48c6f5 +msgid "**Added** \"squiggly\" text marker annotation." +msgstr "" + +#: ../../../changes.txt:1387 a19e2c41c382444eb6b22ea167aa22db +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:1388 8e29ea3f02cb4ab190e5bf6c857a4e7e +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:1389 c54b05c8c3fd495d889c1472b6bb2b8d +msgid "" +"**Added** suppression and redirection of unsolicited messages issued by " +"the underlying C-library MuPDF. Consult :ref:`RedirectMessages` for " +"details." +msgstr "" + +#: ../../../changes.txt:1390 5d2a1026877d49eba2eb4562147797a1 +msgid "" +"**Changed:** Changes to annotations now **always require** " +":meth:`Annot.update` to become effective." +msgstr "" + +#: ../../../changes.txt:1391 a850100e9b2c450c8c2951f502678e48 +msgid "" +"**Changed** free text annotations to support the full Latin character set" +" and range of appearance options." +msgstr "" + +#: ../../../changes.txt:1392 a3d4bf9dd33c4cc685ee355460d69060 +msgid "" +"**Changed** text searching, :meth:`Page.searchFor`, to optionally return " +":ref:`Quad` instead :ref:`Rect` objects surrounding each search hit." +msgstr "" + +#: ../../../changes.txt:1393 f61d6f6c712d40efa946dd907d3d2156 +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:1394 48943c5e7c634e6da285a5e0b276fd8c +msgid "**Fixed** issue 211 (\"Something wrong in the doc\")." +msgstr "" + +#: ../../../changes.txt:1395 4f1693109c504889a792853722b034ef +msgid "" +"**Fixed** issue 213 (\"Rewritten outline is displayed only by mupdf-based" +" applications\")." +msgstr "" + +#: ../../../changes.txt:1396 18f4da70d3534c11a84ad1588902b2dc +msgid "**Fixed** issue 214 (\"PDF decryption GONE!\")." +msgstr "" + +#: ../../../changes.txt:1397 819de41d0fc347b094eb592e123d7214 +msgid "**Fixed** issue 215 (\"Formatting of links added with pyMuPDF\")." +msgstr "" + +#: ../../../changes.txt:1398 7c897ee47a324239affa3abaacc59bb7 +msgid "**Fixed** issue 217 (\"extraction through json is failing for my pdf\")." +msgstr "" + +#: ../../../changes.txt:1400 1cfa6f2a7d86466289606d1d52883e7f +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:1402 f3beb27d6ee34c2db7f4d53eb10fad3b +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:1404 1b6d94cfaf73492b8bfff6473ab80cd6 +msgid "" +"We also invested considerable effort to further extend and improve the " +":ref:`FAQ` chapter." +msgstr "" + +#: ../../../changes.txt:1409 404bdac1d6bd439f88ebfa4748ec0bdf +msgid "**Changes in Version 1.13.19**" +msgstr "" + +#: ../../../changes.txt:1411 49a5943759fb44d8a9dad7f545c958be +msgid "" +"This version contains some technical / performance improvements and bug " +"fixes." +msgstr "" + +#: ../../../changes.txt:1413 5e466f2691d1401684e2692c2c7e742d +#, 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:1414 f407957d8f0a45cf9005220384773edd +msgid "" +"**Fixed** an error occurring in Python 2.7, which crashed the interpreter" +" when using :meth:`TextPage.extractRAWDICT` (= " +"*Page.getText(\"rawdict\")*)." +msgstr "" + +#: ../../../changes.txt:1415 38d92acf823f4cc5a1a284ab58aaf7b8 +msgid "" +"**Fixed** an error occurring in Python 2.7, when creating link " +"destinations." +msgstr "" + +#: ../../../changes.txt:1416 1b580b887c874931947ee9e795b1ec0e +msgid "**Extended** the :ref:`FAQ` chapter with more examples." +msgstr "" + +#: ../../../changes.txt:1420 97eac0dc1cc44244b78f98cf0b91b781 +msgid "**Changes in Version 1.13.18**" +msgstr "" + +#: ../../../changes.txt:1422 e9ca32aebe174b7bb68cb714b035a84a +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:1426 63ccace7d9f24997b7351d0f2fc0fc5a +msgid "**Changes in Version 1.13.17**" +msgstr "" + +#: ../../../changes.txt:1428 61a83d1e3baa4936b777b49c60020c91 +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:1429 ae136b5ee6c140e9846d3afa47060c6c +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:1430 666214314e024bc3883b01ac126f5bb6 +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:1431 60192ad2eb6249c2aa676622324e0993 +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:1432 85720f5819c44f65a7573120e7bab394 +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:1433 3eadc8e42486436da83f34b9967b5c4d +msgid "**Added** a :ref:`FAQ` chapter to this document." +msgstr "" + +#: ../../../changes.txt:1437 0b021b9744c14ff0abc165a55c970340 +msgid "**Changes in Version 1.13.16**" +msgstr "" + +#: ../../../changes.txt:1439 2f58b78a99ba4314bdf7a7552df9b1c6 +msgid "" +"**Added** support for correctly setting transparency (opacity) for " +"certain annotation types." +msgstr "" + +#: ../../../changes.txt:1440 896de4d87cae4cd79cc54a5a685b909c +msgid "" +"**Added** a tool property (:attr:`Tools.fitz_config`) showing the " +"configuration of this PyMuPDF version." +msgstr "" + +#: ../../../changes.txt:1441 b07d36b4b0a34551b29ce642ca966b28 +msgid "" +"**Fixed** issue #193 ('insertText(overlay=False) gives \"cannot resize a " +"buffer with shared storage\" error') by avoiding read-only buffers." +msgstr "" + +#: ../../../changes.txt:1445 15690eaf9d8249179207c0bc1eb766ce +msgid "**Changes in Version 1.13.15**" +msgstr "" + +#: ../../../changes.txt:1447 4cc7827396d34f7d8782be48ee372da8 +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:1448 fb2dc3d949b64b3bb9f6ac4c04f7c5c0 +msgid "" +"**Fixed** issue #191 (\"Jupyter notebook kernel dies after ca. 40 " +"pages\"), which occurred when modifying the contents of an annotation." +msgstr "" + +#: ../../../changes.txt:1452 5395b4ac1da447d9ab5f8c8b78faf0ed +msgid "**Changes in Version 1.13.14**" +msgstr "" + +#: ../../../changes.txt:1454 169f1164dc784d8b9501b360958241a3 +msgid "This patch version contains several improvements, mainly for annotations." +msgstr "" + +#: ../../../changes.txt:1456 8a5a46648a1f40afb26b0fe571fa16a1 +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:1457 d5e16089564647cbbd57dff39153f6c0 +msgid "" +"**Added** support of line end symbols for applicable annotations. PyMuPDF" +" now can generate these annotations including the line end symbols." +msgstr "" + +#: ../../../changes.txt:1458 f7dd2d8e7c294dde9a7e4d6c022cd73d +msgid "" +"**Added** :meth:`Annot.setLineEnds` adds line end symbols to applicable " +"annotation types ('Line', 'PolyLine', 'Polygon')." +msgstr "" + +#: ../../../changes.txt:1459 0211334dabc5496a8b02863a8e7e5d93 +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:1463 961992b2a4bb482f9c3ca251c97af02a +msgid "**Changes in Version 1.13.13**" +msgstr "" + +#: ../../../changes.txt:1465 bd2a25cf05e74346a4c1206144d1e38c +msgid "" +"This patch version contains several improvements for embedded files and " +"file attachment annotations." +msgstr "" + +#: ../../../changes.txt:1467 369d1ae993594218b62ca4e80ff2a5d1 +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:1468 fab4ae75c9c845bdb4424d401d09d57a +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:1469 76e3050de5a948fa8813c15e6eaa61b1 +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:1470 cd550f2982974d2b8d1c75c17c9c85f8 +msgid "" +"**Changed** embedded file methods to now also accept or show the PDF " +"unicode filename as additional parameter *ufilename*." +msgstr "" + +#: ../../../changes.txt:1471 60d1f4803f5741b9aac534f133b52d0b +msgid "" +"**Added** :meth:`Page.add_file_annot` which adds a new file attachment " +"annotation." +msgstr "" + +#: ../../../changes.txt:1472 3a6945b7c0bf471c8dafb6ff0b13ca59 +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:1473 d2842905bbe449d79ad464c676cb08da +msgid "" +"**Changed** :meth:`Annot.fileInfo` (file attachment annot) to now also " +"show the PDF unicode filename as parameter *ufilename*." +msgstr "" + +#: ../../../changes.txt:1474 cbb65f96542945148c3ca83b32894638 +msgid "" +"**Fixed** issue #180 (\"page.getText(output='dict') return invalid " +"bbox\") to now also work for vertical text." +msgstr "" + +#: ../../../changes.txt:1475 e8ffb09825f94fe7b3a438b858d0be61 +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:1479 4d32546167df4973afb0b7abfd1fc872 +msgid "**Changes in Version 1.13.12**" +msgstr "" + +#: ../../../changes.txt:1481 3cf4006168404d068e64e15d1dd06ad6 +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:1482 92edfa5a6a8f4575a8841079361758b0 +msgid "" +"**Changed** for ListBox and ComboBox widgets, the attribute list of " +"selectable values has been renamed to :attr:`Widget.choice_values`." +msgstr "" + +#: ../../../changes.txt:1483 53cab687af07403da3659d852d22da1e +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:1484 9cf83015611a4c3cbe8ae7ad111f45c9 +msgid "" +"**Added** :meth:`Annot.updateWidget` which allows changing existing form " +"fields -- including the field value." +msgstr "" + +#: ../../../changes.txt:1488 b001609947ea42c48b5e5570d6a8b667 +msgid "**Changes in Version 1.13.11**" +msgstr "" + +#: ../../../changes.txt:1490 3acf40fab5cd42328443426d271e155a +msgid "" +"While the preceeding patch subversions only contained various fixes, this" +" version again introduces major new features:" +msgstr "" + +#: ../../../changes.txt:1492 27e2f72d7aae412091eb2d5b2699cff5 +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:1493 3af9d4c62e7e40c5be46e5e56267098e +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:1498 6ee3e96e5d014a1195be5bdcf297c023 +msgid "**Changes in Version 1.13.7**" +msgstr "" + +#: ../../../changes.txt:1500 9313d62a71f5446291e8cd6fb4f582ba +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:1501 ef5ce0767fda468a9ee7d37af1e848b0 +msgid "" +"**Added** :ref:`Annot` creation of many annotations types: sticky notes, " +"free text, circle, rectangle, line, polygon, polyline and text markers." +msgstr "" + +#: ../../../changes.txt:1502 2c0506beaaac47aabd5f74fc26e14cb4 +msgid "" +"**Added** support of annotation transparency (:attr:`Annot.opacity`, " +":meth:`Annot.setOpacity`)." +msgstr "" + +#: ../../../changes.txt:1503 632b462d06da46238eb3da1fed8578a9 +msgid "" +"**Changed** :attr:`Annot.vertices`: point coordinates are now grouped as " +"pairs of floats (no longer as separate floats)." +msgstr "" + +#: ../../../changes.txt:1504 09c3d3cd6cb241588ea2e7165a270851 +msgid "" +"**Changed** annotation colors dictionary: the two keys are now named " +"*\"stroke\"* (formerly *\"common\"*) and *\"fill\"*." +msgstr "" + +#: ../../../changes.txt:1505 62aec107837b4a6f870f0d817654fdd9 +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:1509 ba35b80497ed4fedba9e4b19fda33283 +msgid "**Changes in Version 1.13.6**" +msgstr "" + +#: ../../../changes.txt:1511 a2d3a31f40f04e72af41aea1b821ac25 +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:1515 60820820e2a748baab5ce2ac7cee8cab +msgid "**Changes in Version 1.13.5**" +msgstr "" + +#: ../../../changes.txt:1517 55ab32f2a40847ff9c2321222282d0e4 +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:1518 9fb025ebc01d43a794ea3152ddd7708f +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:1522 f817e60e81fc4dbdbfa1d47e374bdd3a +msgid "**Changes in Version 1.13.4**" +msgstr "" + +#: ../../../changes.txt:1524 2f8ec74241274be4843edd96423edd23 +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:1525 d73352dfb3b44dcd8216080751f55bc8 +msgid "" +"Fixed a bug (introduced with v1.13.0) that prevented " +":meth:`Page.insertImage` for transparent images." +msgstr "" + +#: ../../../changes.txt:1529 ef4f67aa721349d09e675c2a0eab2293 +msgid "**Changes in Version 1.13.3**" +msgstr "" + +#: ../../../changes.txt:1531 4a6cd46143714261ab3e7f69c7defa35 +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:1533 7eb1b55cace04f7b926a6aed58db79ca +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:1537 b099b5049276480982eaad58f8521407 +msgid "**Changes in Version 1.13.2**" +msgstr "" + +#: ../../../changes.txt:1539 a0dbe7fd684a4290a16a905c8abd1a6c +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:1541 30480cb42dc44540811656c83af7d6d2 +msgid "" +":attr:`Document.is_form_pdf` is true if object type */AcroForm* and at " +"least one form field exists." +msgstr "" + +#: ../../../changes.txt:1542 308c0b40318f4dc8b8a44ea9ba1d70f6 +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:1546 e633a30a243244ada6eaa6970be0c53a +msgid "**Changes in Version 1.13.1**" +msgstr "" + +#: ../../../changes.txt:1548 e876d76a91fc4d13bcde903996e93d93 +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:1549 3eab5c2e684d4ca1b2b939343993f16f +msgid "" +":meth:`Page.getText` correspondingly supports the new parameter value " +"*\"dict\"* to invoke the above method." +msgstr "" + +#: ../../../changes.txt:1550 034c735f0f7643069068578aff9f497e +msgid "" +":meth:`TextPage.extractJSON` (resp. *Page.getText(\"json\")*) is still " +"supported for convenience, but its use is expected to decline." +msgstr "" + +#: ../../../changes.txt:1554 1fda37e929aa45c2ba393445d29bf6ed +msgid "**Changes in Version 1.13.0**" +msgstr "" + +#: ../../../changes.txt:1556 3ae6de2ec08743628a6893819b9134af +msgid "" +"This version is based on MuPDF v1.13.0. This release is \"primarily a bug" +" fix release\"." +msgstr "" + +#: ../../../changes.txt:1558 eabccd7f29914085a5768fb57ede536f +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:1560 6f589bcb3774468e9105dbb97eb800f4 +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:1564 5343b0e576c34d9b90c96558383f9d88 +msgid "Changes to :ref:`Pixmap` constructors:" +msgstr "" + +#: ../../../changes.txt:1563 83200dd0977d4b3c8ef4b9ae14518684 +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:1564 25f9652bfd3b40239aa9a8df7eda4556 +msgid "As a replacement, the simple pixmap copy lets you choose the target alpha." +msgstr "" + +#: ../../../changes.txt:1566 68c88a6488f2433bbfea9f75843dd889 +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:1568 14460c2501f0431ea1a1e23680a92019 +msgid "" +":meth:`Document.save` now offers to \"prettify\" PDF source via an " +"additional argument." +msgstr "" + +#: ../../../changes.txt:1569 155b37e331484552afa40e6515b239ca +msgid "" +":meth:`Page.insertImage` has the additional *stream* \\-parameter, " +"specifying a memory area holding an image." +msgstr "" + +#: ../../../changes.txt:1571 b8bb165554894f36a68f3b5b3800d76c +msgid "" +"Issue with garbled PNGs on Linux systems has been resolved (`\"Problem " +"writing PNG\" #133) `_." +msgstr "" + +#: ../../../changes.txt:1576 a3ead717e5954cd2b89c1609045e888e +msgid "**Changes in Version 1.12.4**" +msgstr "" + +#: ../../../changes.txt:1578 5801048459634912900ec0bd3c67c338 +msgid "This is an extension of 1.12.3." +msgstr "" + +#: ../../../changes.txt:1580 5d44b768aca24d6294cb35a32b76e3f9 +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:1581 9f47168310684923aadf5a357a2bb761 +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:1582 e9a17517687643c4a4f74ac80284e094 +msgid "" +"Preventive fix of illegally using stencil / image mask pixmaps in some " +"methods." +msgstr "" + +#: ../../../changes.txt:1583 27ea8c15a9ce477ead1886e8082310b0 +msgid "" +"Method :meth:`Document.getPageFontlist` now includes the encoding name " +"for each font in the list." +msgstr "" + +#: ../../../changes.txt:1584 9e49232f26a74575b240578f50b6943e +msgid "" +"Method :meth:`Document.getPageImagelist` now includes the decode method " +"name for each image in the list." +msgstr "" + +#: ../../../changes.txt:1588 b492cc5f70424496aea34d5ac929c850 +msgid "**Changes in Version 1.12.3**" +msgstr "" + +#: ../../../changes.txt:1590 a8a54c363af04753a61ae219620d2472 +msgid "This is an extension of 1.12.2." +msgstr "" + +#: ../../../changes.txt:1592 d839139235a4411bb6bf0b844d08ad3d +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:1596 258c402addab42abbec397c9d21a72eb +msgid "**Changes in Version 1.12.2**" +msgstr "" + +#: ../../../changes.txt:1598 6e66b5d392b44a5a9ae7964883d15a8a +msgid "This is an extension of 1.12.1." +msgstr "" + +#: ../../../changes.txt:1600 1aa09fdd07a84cc6b6896e6aa84d1d32 +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:1602 3fa0af3f80cc4a3c8985dd5fca9d12a8 +msgid "" +"New :attr:`Page.CropBox` and :attr:`Page.MediaBox` have been included for" +" convenience." +msgstr "" + +#: ../../../changes.txt:1607 003547c1efd5480db5bb6bd98b7f9d4d +msgid "**Changes in Version 1.12.1**" +msgstr "" + +#: ../../../changes.txt:1609 4c4dfcfaebd44e82bb409f282c41c73c +msgid "This is an extension of version 1.12.0." +msgstr "" + +#: ../../../changes.txt:1611 a9fe9828c9bb40138e1c495a3a23e08e +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:1613 5e343c0bd59c421ca16170c7061e2769 +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:1615 8ab01eb18dc14d7fa755cc48705a0a3b +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:1617 b1a3b60ad3d34a99b324735729225bea +msgid "Minor bug fixes." +msgstr "" + +#: ../../../changes.txt:1619 be01dc2c90b54242bfec5879e15cea40 +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:1621 fc41c0a4476546c19e558e3cba69774c +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:1625 2eae3373a782431aafc0a0edcf50529b +msgid "**Changes in Version 1.12.0**" +msgstr "" + +#: ../../../changes.txt:1627 506c22720df341e4ae622c66eafd0140 +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:1629 75c40b8be7224de4bbd1abacf30d8c89 +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:1631 bcd7d87df37e47159c701cfaa2543dd3 +msgid "Class *TextSheet* does no longer exist." +msgstr "" + +#: ../../../changes.txt:1633 31d3f46b93174c449ac10037d699ae2e +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:1635 26f334675e0e4f5c9fcbb99556e4978a +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:1637 07d37f7b4c3348fc9b67fe14e778e75f +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:1639 e7f223c1d8914a7ba905d7dd98e848bf +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:1641 ac57e434e1d44edc83a329392828d1ad +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:1646 0b743cfd5115456bb25798fd8ed3fbb2 +msgid "**Changes in Version 1.11.2**" +msgstr "" + +#: ../../../changes.txt:1648 9b5c4e53c0064be386696f2322d26014 +msgid "This is an extension of v1.11.1." +msgstr "" + +#: ../../../changes.txt:1650 e2d0513153294bcc8762ca0c29a071c4 +msgid "" +"New :meth:`Page.insertFont` creates a PDF */Font* object and returns its " +"object number." +msgstr "" + +#: ../../../changes.txt:1652 7237f350aac34263a1643d3b63a2154f +msgid "" +"New :meth:`Document.extractFont` extracts the content of an embedded font" +" given its object number." +msgstr "" + +#: ../../../changes.txt:1654 463ce0a8ac5f4d27a50a08859bdfa23d +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:1656 e28034cd75f4419cb6028bb8a8ca1f53 +msgid "Fonts other than \"simple fonts\" (Type1) are now also supported." +msgstr "" + +#: ../../../changes.txt:1658 d05ab638d11e4ae9b1c9a8b70eccb40f +msgid "New options to change :ref:`Pixmap` size:" +msgstr "" + +#: ../../../changes.txt:1660 d41df8a161eb4ba69e01e26f7ca3ef9b +msgid "Method :meth:`Pixmap.shrink` reduces the pixmap proportionally in place." +msgstr "" + +#: ../../../changes.txt:1662 90a385c3dfc04ab7868e49d2451e24bd +msgid "" +"A new :ref:`Pixmap` copy constructor allows scaling via setting target " +"width and height." +msgstr "" + +#: ../../../changes.txt:1667 0ad21fcba4254f79bc2fa70bddb0d182 +msgid "**Changes in Version 1.11.1**" +msgstr "" + +#: ../../../changes.txt:1669 25174e9ad85f40f4baeaf80ff62b949a +msgid "This is an extension of v1.11.0." +msgstr "" + +#: ../../../changes.txt:1671 aec7aa89b85a4129a5ba44d8991eeba1 +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:1673 e48cf8fae60744ffb4539f315864ca6d +msgid "All *Page* draw methods now use the new *Shape* class." +msgstr "" + +#: ../../../changes.txt:1675 87b010994ae04e8fb1217d9cfef58d70 +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:1677 481279bf2fde43f0839126063cc47a46 +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:1679 86377201590d4ec2b998f70c799dbb37 +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:1681 645f9d2caf9c4eee82881839dbfc4eaf +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:1685 2e55a55b92234fbf86aba26a359eb1ac +msgid "**Changes in Version 1.11.0**" +msgstr "" + +#: ../../../changes.txt:1687 bdfeb760dce9456a9e21666ed4dd85a0 +msgid "This version is based on and requires MuPDF v1.11." +msgstr "" + +#: ../../../changes.txt:1689 8e03c233872e48c8866caa0f42720173 +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:1691 9fcc965d610b4db08faa78bcdc1b53cd +msgid "" +"The *Document* class now support embedded files with several new methods " +"and one new property:" +msgstr "" + +#: ../../../changes.txt:1693 123da596668e4a1a9bfcfd822ce6355f +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:1694 42b21d0161fe4766bab44b7e29da6b07 +msgid "" +"*embfile_Get()* retrieves the (decompressed) content of an entry into a " +"*bytes* buffer." +msgstr "" + +#: ../../../changes.txt:1695 d87735d329974e54a54be22b7e16337e +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:1696 5b3d51a2870542d2be656fb5a0792a39 +msgid "" +"*embfile_Del(...)* deletes an entry from the portfolio (function not " +"offered in MuPDF)." +msgstr "" + +#: ../../../changes.txt:1697 4f763b96c6e3408d99dc3a97d26d6d57 +msgid "" +"*embfile_SetInfo()* -- changes filename or description of an embedded " +"file." +msgstr "" + +#: ../../../changes.txt:1698 581be7a442e94929badbde79bc726547 +msgid "*embfile_Count* -- contains the number of embedded files." +msgstr "" + +#: ../../../changes.txt:1700 463f15d4d3bf4f05b3cd9709acd00658 +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:1702 22048ed449f44b9f9d8520489323f50f +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:1704 ffe7888bcb5e43149cd067c9319d0006 +msgid "We have started basic support for **generation** of PDF content:" +msgstr "" + +#: ../../../changes.txt:1706 b6284fff488a43bf8b9364d8c370ad46 +msgid "" +"*Document.insert_page()* adds a new page into a PDF, optionally " +"containing some text." +msgstr "" + +#: ../../../changes.txt:1707 ef5055ffc880482bb20d443315162a39 +msgid "*Page.insertImage()* places a new image on a PDF page." +msgstr "" + +#: ../../../changes.txt:1708 3423c817d20b4828a4d487e223b1ad97 +msgid "*Page.insertText()* puts new text on an existing page" +msgstr "" + +#: ../../../changes.txt:1710 4f3f1b652ae942db84155d18d801a2e2 +msgid "" +"For **FileAttachment** annotations, content and name of the attached file" +" can extracted and changed." +msgstr "" + +#: ../../../changes.txt:1714 5a89273d7bc349f9bc6339e5353b95e1 +msgid "**Changes in Version 1.10.0**" +msgstr "" + +#: ../../../changes.txt:1716 0c4dbd50649d4ce6a8bae829e6966f0b +msgid "**MuPDF v1.10 Impact**" +msgstr "" + +#: ../../../changes.txt:1718 7cdb97e1b0dd45df8ed3cda57c983dc3 +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:1720 363b8f0abcf742069e1542fe8ecade6b +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:1722 5cb9f267827a4d64a76db27ad7098c5b +msgid "" +"In an effort to minimize memory requirements, several improvements have " +"been built into MuPDF v1.10:" +msgstr "" + +#: ../../../changes.txt:1724 f6029a337429453496fa692da8fe3155 +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:1726 bd6b9b5f4a194b76acb8df3d4aab4ae7 +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:1728 f567bbaca62e4d30b612dbb64023a483 +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:1730 494a44d4bf8f4991871bbb33ccc0384c +msgid "**Other Changes compared to Version 1.9.3**" +msgstr "" + +#: ../../../changes.txt:1732 78aad415117446e4b1f018de1df9f3ad +msgid "" +"The new :ref:`Document` method *write()* writes an opened PDF to memory " +"(as opposed to a file, like *save()* does)." +msgstr "" + +#: ../../../changes.txt:1733 0ea35021e8f348e9bb0838c515096bc1 +msgid "" +"An annotation can now be scaled and moved around on its page. This is " +"done by modifying its rectangle." +msgstr "" + +#: ../../../changes.txt:1734 88361bdd158b47bca1778fc649b65f4f +msgid "" +"Annotations can now be deleted. :ref:`Page` contains the new method " +"*deleteAnnot()*." +msgstr "" + +#: ../../../changes.txt:1735 01be43f9febf4e449e36035b5345ee58 +msgid "" +"Various annotation attributes can now be modified, e.g. content, dates, " +"title (= author), border, colors." +msgstr "" + +#: ../../../changes.txt:1736 0f5c95d633e54da88618001f934347d9 +msgid "" +"Method *Document.insert_pdf()* now also copies annotations of source " +"pages." +msgstr "" + +#: ../../../changes.txt:1737 41e5a61a2f0145bba2472328fe2fb64c +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:1738 df493108785c4485a3120c25aa14ce3f +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:1739 7708bd22411c43d9b7a5bff9c5a6d4d1 +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:1740 b4692a5e01ca4d6094754689380fb4f3 +msgid "" +"The :ref:`Pixmap` method *getSize()* has been replaced with property " +"*size*. As before *Pixmap.size == len(Pixmap)* is true." +msgstr "" + +#: ../../../changes.txt:1741 b3556ee6fda7428bad6215367e7ab91e +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:1742 329f7a997b324ab492c2e5b4a9787c7f +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:1743 d78287ab534149bbae05216993ca9b24 +msgid "" +":ref:`Pixmap` methods *samplesRGB()* and *samplesAlpha()* have been " +"deleted because pixmaps can now be created without transparency." +msgstr "" + +#: ../../../changes.txt:1744 5e7217b462cb4467b6e0cabfed10a9ee +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:1745 2e79e566446a477fabe3e24bd4e058ce +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:1750 605cdf32f8114f27bbf8812b03040888 +msgid "**Changes in Version 1.9.3**" +msgstr "" + +#: ../../../changes.txt:1752 9fb130fb3e5b4fbb99cf780f3d346b78 +msgid "" +"This version is also based on MuPDF v1.9a. Changes compared to version " +"1.9.2:" +msgstr "" + +#: ../../../changes.txt:1754 e5d9ec538b2e481a88c7920072c0062d +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:1755 04ed809f1717460c861fe53061985cf5 +msgid "" +"In addition to the document *select()* method, some simpler methods can " +"now be used to manipulate a PDF:" +msgstr "" + +#: ../../../changes.txt:1757 a1f6b065d1a446ea8e67567318961cef +msgid "*copyPage()* copies a page within a document." +msgstr "" + +#: ../../../changes.txt:1758 4a64dbd8ba724f6e8c64c82de1148d14 +msgid "*movePage()* is similar, but deletes the original." +msgstr "" + +#: ../../../changes.txt:1759 8ce5b957e8ea4d8593f40cca96022ce3 +msgid "*delete_page()* deletes a page" +msgstr "" + +#: ../../../changes.txt:1760 218ba557cbd44cb08302377bfc93011e +msgid "*delete_pages()* deletes a page range" +msgstr "" + +#: ../../../changes.txt:1762 ef9c326d391246b282389cbb9e195f23 +msgid "" +"*rotation* or *setRotation()* access or change a PDF page's rotation, " +"respectively." +msgstr "" + +#: ../../../changes.txt:1763 ff104ab08bc64427a593025a85dff02a +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:1764 df82a085cfbc4ca995ad44494d55ece3 +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:1768 504aff18a24c48299a463c5c9220a00c +msgid "**Changes in Version 1.9.2**" +msgstr "" + +#: ../../../changes.txt:1770 4bd6af693e1d4e7c866f82cf61b3a164 +msgid "" +"This version is also based on MuPDF v1.9a. Changes compared to version " +"1.9.1:" +msgstr "" + +#: ../../../changes.txt:1772 8d780efe6cd64ab2af4f0a4eb9af788c +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:1773 9f4bfbc5e9234aa88f00b3d53ea9c501 +msgid "" +":ref:`Document` now accepts all of the following formats (*Document* and " +"*open* are synonyms):" +msgstr "" + +#: ../../../changes.txt:1775 734a1ef079d940fd918ebc43a0b0290f +msgid "*open()*," +msgstr "" + +#: ../../../changes.txt:1776 b4b23882fd5c4123930c037376796b75 +msgid "*open(filename)* (equivalent to *open(filename, None)*)," +msgstr "" + +#: ../../../changes.txt:1777 70ff84205c8b4af0aac7845b06189cfc +msgid "*open(filetype, area)* (equivalent to *open(filetype, stream = area)*)." +msgstr "" + +#: ../../../changes.txt:1779 1b43fe567159404aa77ed9a7a422160c +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:1780 605ccfe18906406d99e5aa875cc87d5f +msgid "" +"New method *Document.insert_pdf()* (PDFs only) inserts a range of pages " +"from another PDF." +msgstr "" + +#: ../../../changes.txt:1781 65824bf2d81748238b53dff842ec0d0d +msgid "" +"*Document* objects doc now support the *len()* function: ``len(doc) == " +"doc.pageCount``." +msgstr "" + +#: ../../../changes.txt:1782 d217fd60ae3a440a96a0944cf44455fb +msgid "" +"New method *Document.getPageImageList()* creates a list of images used on" +" a page." +msgstr "" + +#: ../../../changes.txt:1783 e4e8077abc6442e4a591b922ca159add +msgid "" +"New method *Document.getPageFontList()* creates a list of fonts " +"referenced by a page." +msgstr "" + +#: ../../../changes.txt:1784 35b79eeb8a5040908bbecd82e126adf4 +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:1785 dbd40807819d4329a4436c8683a0edc1 +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:1786 2c895f9b91604bc793ee95cd5da1c885 +msgid "" +"Pixmap constructor *fitz.Pixmap(colorspace, width, height, samples)* now " +"allows *samples* to also be *bytes*, not only *bytearray*." +msgstr "" + +#: ../../../changes.txt:1791 8e5cdc8e0a1c49a7af1e5b5706a5a36a +msgid "**Changes in Version 1.9.1**" +msgstr "" + +#: ../../../changes.txt:1793 cba0f9ffbc214110821f5f477de0afe5 +msgid "" +"This version of PyMuPDF is based on MuPDF library source code version " +"1.9a published on April 21, 2016." +msgstr "" + +#: ../../../changes.txt:1795 6e808077b7e34d279099721252b489b6 +msgid "" +"Please have a look at MuPDF's website to see which changes and " +"enhancements are contained herein." +msgstr "" + +#: ../../../changes.txt:1797 84662fb63a4c43d89f805529ed4b3cd0 +msgid "Changes in version 1.9.1 compared to version 1.8.0 are the following:" +msgstr "" + +#: ../../../changes.txt:1799 327f1c3bbf794cd9812925a5a3b17cdd +msgid "New methods *get_area()* for both *fitz.Rect* and *fitz.IRect*" +msgstr "" + +#: ../../../changes.txt:1800 2ab440150a9949f5b6e6c554c9b407f4 +msgid "" +"Pixmaps can now be created directly from files using the new constructor " +"*fitz.Pixmap(filename)*." +msgstr "" + +#: ../../../changes.txt:1801 b4a4f7ac3d9a4401be79e04fc30d2fd3 +msgid "The Pixmap constructor *fitz.Pixmap(image)* has been extended accordingly." +msgstr "" + +#: ../../../changes.txt:1802 a15a962a954d4a2b820c2cc3eeb6d661 +msgid "" +"*fitz.Rect* can now be created with all possible combinations of points " +"and coordinates." +msgstr "" + +#: ../../../changes.txt:1803 05dcfa767c7e4b39bb4ec33b1b9b655c +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:1804 8a10393ad7894f5b8f9152ae7086d7a5 +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:1805 3a336a21404f49cab4e6fd6bf580eee9 +msgid "The identity matrix *fitz.Identity* is now **immutable**." +msgstr "" + +#: ../../../changes.txt:1806 7f0025011f3f4717a13fee4479eb71a1 +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:1807 29c346a79e67408b899ca023800a4173 +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:1808 75bbbd6cd6d94d4fa98f230336552bf3 +msgid "*fitz.open()* is now an alias of *fitz.Document()*." +msgstr "" + +#: ../../../changes.txt:1809 38a011ad8d4c4468ab26ccb50433c2ba +msgid "" +"New pixmap method *tobytes()* which will return a bytearray formatted as " +"a PNG image of the pixmap." +msgstr "" + +#: ../../../changes.txt:1810 140114ad6260405295df7c9278bc31e1 +msgid "" +"New pixmap method *samplesRGB()* providing a *samples* version with alpha" +" bytes stripped off (RGB colorspaces only)." +msgstr "" + +#: ../../../changes.txt:1811 a9dc70fd3dde4696a7625d26fb7c8269 +msgid "" +"New pixmap method *samplesAlpha()* providing the alpha bytes only of the " +"*samples* area." +msgstr "" + +#: ../../../changes.txt:1812 3b15b5cb67e7440ea17c800c841ef563 +msgid "New iterator *fitz.Pages(doc)* over a document's set of pages." +msgstr "" + +#: ../../../changes.txt:1813 802c96a9ebc24835a35c7071fe651ccc +msgid "" +"New matrix methods *invert()* (calculate inverted matrix), *concat()* " +"(calculate matrix product), *pretranslate()* (perform a shift operation)." +msgstr "" + +#: ../../../changes.txt:1814 63a94db9b54a4b0da8ea2f7c32b10328 +msgid "" +"New *IRect* methods *intersect()* (intersection with another rectangle), " +"*translate()* (perform a shift operation)." +msgstr "" + +#: ../../../changes.txt:1815 0105e19d253341a8ab6b07fa76f36026 +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:1816 b9e3d0ccec79478ba10a52878d9e977f +msgid "Documented *Point.transform()* (transform a point with a matrix)." +msgstr "" + +#: ../../../changes.txt:1817 7f4b431fd2054427954f61dfc4c5227b +msgid "" +"*Matrix*, *IRect*, *Rect* and *Point* classes now support compact, " +"algebraic formulations for manipulating such objects." +msgstr "" + +#: ../../../changes.txt:1818 489700bf71f9472c964d91dcf88b6d1f +msgid "" +"Incremental saves for changes are possible now using the call pattern " +"*doc.save(doc.name, incremental=True)*." +msgstr "" + +#: ../../../changes.txt:1819 0fa3804b383446c3ad90da659704bd8a +msgid "" +"A PDF's metadata can now be deleted, set or changed by document method " +"*set_metadata()*. Supports incremental saves." +msgstr "" + +#: ../../../changes.txt:1820 5d15df2e12c84a96b94958bf581db80a +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:-1 590f2854b2974410bf908a2e797d9dd1 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/classes.mo b/docs/locales/ja/LC_MESSAGES/classes.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/classes.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/classes.po b/docs/locales/ja/LC_MESSAGES/classes.po new file mode 100644 index 000000000..911fd1a66 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/classes.po @@ -0,0 +1,29 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../classes.rst:5 fdf5ebf7f71145e98def49eedd0dab5d +msgid "Classes" +msgstr "" + +#: ../../footer.rst:-1 8dbdad62621a4a23b8424a65e843406c +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/colors.mo b/docs/locales/ja/LC_MESSAGES/colors.mo new file mode 100644 index 000000000..56fb4e6c2 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/colors.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/colors.po b/docs/locales/ja/LC_MESSAGES/colors.po new file mode 100644 index 000000000..ffcbc5e88 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/colors.po @@ -0,0 +1,81 @@ +# 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" + +#: ../../colors.rst:7 6bb56bfa8ebd4893b801993260bcc867 +msgid "Color Database" +msgstr "カラーデータベース" + +#: ../../colors.rst:8 fc257a50ba8f42738dcf5e18111869c6 +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 144d83f062d24e848a4c9a51f3f481c9 +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 96584832e75449eeb10e852094d063ba +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 46c2ab089d75469c935cd1e793b209f8 +msgid "Function *getColor()*" +msgstr "関数 *getColor()* " + +#: ../../colors.rst:16 7fb73e536a9c4442998afe9816b98bff +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 525b66a507f44c5b88cc456cbff8d856 +msgid "Printing the Color Database" +msgstr "カラーデータベースの印刷" + +#: ../../colors.rst:42 ea6921b8174345b9a98b57b98a25edfd +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:-1 e109b2492b1d401cbeebb743c9c41ede +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/colorspace.mo b/docs/locales/ja/LC_MESSAGES/colorspace.mo new file mode 100644 index 000000000..9f640e216 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/colorspace.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/colorspace.po b/docs/locales/ja/LC_MESSAGES/colorspace.po new file mode 100644 index 000000000..fbcf815e2 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/colorspace.po @@ -0,0 +1,98 @@ +# 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" + +#: ../../colorspace.rst:7 a086efe19d644d6a9a81f87d808e4adb +msgid "Colorspace" +msgstr "Colorspace (カラースペース)" + +#: ../../colorspace.rst:9 d9a7d696c581492b90c82c9abc6b885f +msgid "Represents the color space of a :ref:`Pixmap`." +msgstr ":ref:`Pixmap` のカラースペースを表します。" + +#: ../../colorspace.rst:12 1f2c331405804319b0b3d6ca8ce00221 +msgid "**Class API**" +msgstr "**クラス API** " + +#: ../../colorspace.rst:18 711f6a6009294915af6aa216becba436 +msgid "Constructor" +msgstr "コンストラクタ" + +#: ../../colorspace.rst 7db7c78c0dc74cde9f70f28b78c44182 +msgid "Parameters" +msgstr "パラメータ:" + +#: ../../colorspace.rst:20 3bcc93b28913457b901886504a9c7d61 +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 dd5148c548834c1fb5cdda367cca92a0 +msgid "" +"The name identifying the colorspace. Example: *fitz.csCMYK.name = " +"'DeviceCMYK'*." +msgstr "カラースペースを識別する名前です。例: *fitz.csCMYK.name = 'DeviceCMYK'* 。" + +#: ../../colorspace.rst 889aa9982a5b45efb8a7470956499445 +#: 8bc0f0b07eae469faae2f36e3abbf02d +msgid "type" +msgstr "型:" + +#: ../../colorspace.rst:26 5151039dbfce44188e155c42919b292f +msgid "str" +msgstr "" + +#: ../../colorspace.rst:30 232b8e7cd11f4521a068c54501d208d1 +msgid "" +"The number of bytes required to define the color of one pixel. Example: " +"*fitz.csCMYK.n == 4*." +msgstr "1ピクセルの色を定義するのに必要なバイト数です。例: *fitz.csCMYK.n == 4* 。" + +#: ../../colorspace.rst:32 afad5de574fd4094944915c6cf25dd21 +msgid "int" +msgstr "" + +#: ../../colorspace.rst:35 aa85b4ae9c2c4f6c97f9fa99dd11e371 +msgid "**Predefined Colorspaces**" +msgstr "**事前定義済みのカラースペース** " + +#: ../../colorspace.rst:37 67ac2bb221074744ae5bee2866d6bf19 +msgid "" +"For saving some typing effort, there exist predefined colorspace objects " +"for the three available cases." +msgstr "入力を簡略化するために、三つの利用可能なケースのための事前定義されたカラースペースオブジェクトが存在します。" + +#: ../../colorspace.rst:39 adbdf7e983d242cc9776a96cb86dbe93 +msgid ":data:`csRGB` = *fitz.Colorspace(fitz.CS_RGB)*" +msgstr "" + +#: ../../colorspace.rst:40 52b57770cbef4f809423d966fa37a4b0 +msgid ":data:`csGRAY` = *fitz.Colorspace(fitz.CS_GRAY)*" +msgstr "" + +#: ../../colorspace.rst:41 9e3e0b378ffc40d2a92864ae2cc15ab2 +msgid ":data:`csCMYK` = *fitz.Colorspace(fitz.CS_CMYK)*" +msgstr "" + +#: ../../footer.rst:-1 456edaf1fb20488cb1b86e10a4f89d5a +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/coop_low.mo b/docs/locales/ja/LC_MESSAGES/coop_low.mo new file mode 100644 index 000000000..eb000e8f6 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/coop_low.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/coop_low.po b/docs/locales/ja/LC_MESSAGES/coop_low.po new file mode 100644 index 000000000..402fde28a --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/coop_low.po @@ -0,0 +1,155 @@ +# 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" + +#: ../../coop_low.rst:7 f010bbfde5024d8687d4eace83cdb620 +msgid "Working together: DisplayList and TextPage" +msgstr "共同作業：DisplayList と TextPage" + +#: ../../coop_low.rst:8 bf2e76c384454b07a67fa752eda82566 +msgid "Here are some instructions on how to use these classes together." +msgstr "これらのクラスを一緒に使用する方法に関するいくつかの手順があります。" + +#: ../../coop_low.rst:10 1e5f60e1680747b390a3643e526d3fec +msgid "" +"In some situations, performance improvements may be achievable, when you " +"fall back to the detail level explained here." +msgstr "一部の状況では、ここで説明されている詳細レベルに戻ると、パフォーマンスの向上が可能かもしれません。" + +#: ../../coop_low.rst:13 f10a7386b8aa489cb8f3adb4f99b32fb +msgid "Create a DisplayList" +msgstr "DisplayList の作成" + +#: ../../coop_low.rst:14 d7cb4799d99e4d1298a8bac1faa1d95d +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 05f56b4999824f3488fdcb992556f8e2 +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 c2e75af6a8b840009ad7ebf2155e077b +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 36089181da8b4fdd80ddd7446f24f0a6 +msgid "Generate Pixmap" +msgstr "ピクセルマップの生成" + +#: ../../coop_low.rst:24 f215ceccecd5464bbec11453cd447533 +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 56d1fbc3e97b431ba3987afe52ef949f +#, 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 0fa331edb9c1460fb5a0b5b110db1ab8 +msgid "Perform Text Search" +msgstr "テキスト検索を実行" + +#: ../../coop_low.rst:32 52259158182246578ed80f54c8a3f771 +msgid "With the display list from above, we can also search for text." +msgstr "上記のディスプレイリストを使用して、テキストを検索することもできます。" + +#: ../../coop_low.rst:34 a7c0f435697a4763806828a297ae7b0b +msgid "For this we need to create a :ref:`TextPage`." +msgstr "これには、:ref:`TextPage` を作成する必要があります。" + +#: ../../coop_low.rst:42 0d2cd997ff044e339e3a60b0732f22ea +msgid "Extract Text" +msgstr "テキストの抽出" + +#: ../../coop_low.rst:43 234a416d209b4519aac3466b0ac9a3e3 +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 0527fd93197446069fb7a053ac9a9c8d +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 83154e0055ae4523aeba2cc99a46a316 +msgid "Further Performance improvements" +msgstr "さらなるパフォーマンスの向上" + +#: ../../coop_low.rst:56 516d5df410ef4d988195975727ce248d +msgid "Pixmap" +msgstr "" + +#: ../../coop_low.rst:57 8201bd00164d409db17c1b48798715d7 +msgid "As explained in the :ref:`Page` chapter:" +msgstr "ページの章で説明されているように：" + +#: ../../coop_low.rst:59 66280224d19f4202b4010a19363d4df5 +#, 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 9d543c0e730448669ee824223684f6d0 +msgid "TextPage" +msgstr "" + +#: ../../coop_low.rst:63 c076feaedf7046c88f223d3746df9129 +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 6a3fee87a6054cc1b024534d6622bac0 +#, 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 772340947d2e4b94be8ad3e7359b810f +msgid "If you however do need images, use a value of 7 for flags:" +msgstr "ただし、画像が必要な場合は、フラグに7の値を使用してください：" + +#: ../../footer.rst:-1 1a95b894f50242898ce55e853a99756a +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/deprecated.mo b/docs/locales/ja/LC_MESSAGES/deprecated.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/deprecated.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/deprecated.po b/docs/locales/ja/LC_MESSAGES/deprecated.po new file mode 100644 index 000000000..d75c9baca --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/deprecated.po @@ -0,0 +1,881 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../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 "" + diff --git a/docs/locales/ja/LC_MESSAGES/device.mo b/docs/locales/ja/LC_MESSAGES/device.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/device.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/device.po b/docs/locales/ja/LC_MESSAGES/device.po new file mode 100644 index 000000000..91aacc0f6 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/device.po @@ -0,0 +1,77 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../device.rst:7 c189461a93df47a0853fc092ed3cd89e +msgid "Device" +msgstr "" + +#: ../../device.rst:9 53e79f7d22de463d80f37e5713836ce7 +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 "" + +#: ../../device.rst:11 811b18f2fa0c4b49882f644216bc62a0 +msgid "**Class API**" +msgstr "" + +#: ../../device.rst:17 aba3421c101a4e7895df4c38794f66c2 +msgid "Constructor for either a pixel map or a display list device." +msgstr "" + +#: ../../device.rst a3415dca6bff4161a1ae6b19e61041df +#: fd2950cf92e14a1f8bdab281119845c5 +msgid "Parameters" +msgstr "" + +#: ../../device.rst:19 685d643540694929b5fb2e38f8216233 +msgid "either a *Pixmap* or a *DisplayList*." +msgstr "" + +#: ../../device.rst:22 f7d008f7366d4c958e5fd59065ba6da0 +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 "" + +#: ../../device.rst:27 165f2279bc934243b9d014af4b778acd +msgid "Constructor for a text page device." +msgstr "" + +#: ../../device.rst:29 df0ddba5473142e5bd34faa70b4b4c18 +msgid "*TextPage* object" +msgstr "" + +#: ../../device.rst:32 d327607bc40a41249519ce7095fad412 +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:-1 c555ef9f3233499382e52037ad11f668 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/displaylist.mo b/docs/locales/ja/LC_MESSAGES/displaylist.mo new file mode 100644 index 000000000..f1937651b Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/displaylist.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/displaylist.po b/docs/locales/ja/LC_MESSAGES/displaylist.po new file mode 100644 index 000000000..f1cedad61 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/displaylist.po @@ -0,0 +1,225 @@ +# 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" + +#: ../../displaylist.rst:7 623c65a123ee40f0a1e3b57b1dafd62a +msgid "DisplayList" +msgstr "DisplayList（ディスプレイリスト）" + +#: ../../displaylist.rst:9 bad034b8c1b34ee58688f1a11697c96e +msgid "" +"DisplayList is a list containing drawing commands (text, images, etc.). " +"The intent is two-fold:" +msgstr "DisplayListは、描画コマンド（テキスト、画像など）を含むリストです。その目的は二つあります：" + +#: ../../displaylist.rst:11 9cd615bddca344a6850a931f22f25664 +msgid "as a caching-mechanism to reduce parsing of a page" +msgstr "ページのパースを削減するためのキャッシュメカニズムとして" + +#: ../../displaylist.rst:12 5f9c01297b9b407abdb87b9fbe45a9cd +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 32e39db48f2f4d5ea7153f678ccd96ac +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 b01c83397c434d7bbb82da14ea9f4e2f +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 3e1c755a8a3b4292aece32d86892889b +msgid "**Method**" +msgstr "**メソッド** " + +#: ../../displaylist.rst:20 95785a3ae32140e7bec573bbb6265185 +msgid "**Short Description**" +msgstr "**短い説明** " + +#: ../../displaylist.rst:22 965d04ae8ddc422aa3d7ff10fda659c0 +msgid ":meth:`~DisplayList.run`" +msgstr "" + +#: ../../displaylist.rst:22 b92e178bcea749bc976c9243af30afc5 +msgid "Run a display list through a device." +msgstr "ディスプレイリストをデバイスを介して実行します。" + +#: ../../displaylist.rst:23 cdf9a66ecf9942b1b942962149302a8d +msgid ":meth:`~DisplayList.get_pixmap`" +msgstr "" + +#: ../../displaylist.rst:23 609ccf81faf44c1ba84317d6475b5efa +msgid "generate a pixmap" +msgstr "ピクスマップを生成します。" + +#: ../../displaylist.rst:24 b000e536998343078b98f69d46c1a2ca +msgid ":meth:`~DisplayList.get_textpage`" +msgstr "" + +#: ../../displaylist.rst:24 f66b623a62f94732acca5013b03f566d +msgid "generate a text page" +msgstr "テキストページを生成します。" + +#: ../../displaylist.rst:25 663c46922e2d4b1c918753be6a3fa7e2 +msgid ":attr:`~DisplayList.rect`" +msgstr "" + +#: ../../displaylist.rst:25 c738a56b9063424f9cf428a84f9ec9eb +msgid "mediabox of the display list" +msgstr "ディスプレイリストのメディアボックス（表示領域）です。" + +#: ../../displaylist.rst:29 5e8cec3a90b2427aa8c3a445e74ea188 +msgid "**Class API**" +msgstr "**Class API（クラスAPI）** " + +#: ../../displaylist.rst:35 878b4917eda24bb3a0e9774b1cd56c3f +msgid "Create a new display list." +msgstr "新しいディスプレイリストを作成します。" + +#: ../../displaylist.rst 9e84c187e8a74c4e8039b67cdb0a2680 +#: cb20e8166c2c42cb956b32e80d7360a7 e03c1906fc924f04841da7373389b4a0 +#: e3bd31cece6b42799596b23be8592560 +msgid "Parameters" +msgstr "パラメーター" + +#: ../../displaylist.rst:37 b464f7eb246d45b288677ebf5fbad26e +msgid "The page's rectangle." +msgstr "ページの矩形。" + +#: ../../displaylist.rst 5d0cb2bc95eb4894a86a39934d046eb0 +#: 64d50553147e479199f397fd51b777ef d1d093b2f86e449ea014ea4463835444 +msgid "Return type" +msgstr "戻り値の型" + +#: ../../displaylist.rst:40 b36cbcd99a8e4f56bc3cb3efe6503e73 +msgid "*DisplayList*" +msgstr "" + +#: ../../displaylist.rst:44 42641b4b67614fae95fdc5b8f8179715 +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 1fbd70fbec55442bb143342629bb2838 +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 b1dde3b7712d4865b46f3419f4ed2415 +msgid "Device" +msgstr "デバイス" + +#: ../../displaylist.rst:51 058e32e79ec0408386d7189abeb5ca7a +msgid "Transformation matrix to apply to the display list contents." +msgstr "ディスプレイリストのコンテンツに適用する変換行列。" + +#: ../../displaylist.rst:54 d5738d9ab9ec423097a15ac27e348d27 +msgid "" +"Only the part visible within this area will be considered when the list " +"is run through the device." +msgstr "デバイスを介してリストを実行する際にこの領域内で可視部分のみが考慮されます。" + +#: ../../displaylist.rst:65 7342aca2485e47f881261132ea551dab +msgid "Run the display list through a draw device and return a pixmap." +msgstr "ディスプレイリストを描画デバイスを介して実行し、ピクスマップを返します。" + +#: ../../displaylist.rst:67 04d8cf142c56472589713dd84b479463 +msgid "matrix to use. Default is the identity matrix." +msgstr "使用する行列。デフォルトは単位行列です。" + +#: ../../displaylist.rst:70 9a7ef18f047f40e09c9bea3878030ce5 +msgid "the desired colorspace. Default is RGB." +msgstr "望ましいカラースペース。デフォルトはRGBです。" + +#: ../../displaylist.rst:73 d9ad71b94c6e46e099972714e668d2d8 +msgid "determine whether or not (0, default) to include a transparency channel." +msgstr "透明チャネルを含めるかどうかを決定します（0、デフォルトは含めない）。" + +#: ../../displaylist.rst:75 b615d03d86154218a98727b058819b01 +msgid "" +"restrict rendering to the intersection of this area with " +":attr:`DisplayList.rect`." +msgstr ":attr:`DisplayList.rect` との交差部分にレンダリングを制限します。" + +#: ../../displaylist.rst:77 a08a179f9c6343688007a3546a275bda +msgid ":ref:`Pixmap`" +msgstr "" + +#: ../../displaylist.rst 03838ba4dcb54647b6a03afd1984cd1a +#: 7323e19363f6456ba2dbbb7133120e36 +msgid "Returns" +msgstr "戻り値" + +#: ../../displaylist.rst:78 3272f5af6c40494491148ece4bdf912c +msgid "pixmap of the display list." +msgstr "ディスプレイリストのピクスマップ。" + +#: ../../displaylist.rst:82 25f66ceae140495e815602406f9738b4 +msgid "Run the display list through a text device and return a text page." +msgstr "ディスプレイリストをテキストデバイスを介して実行し、テキストページを返します。" + +#: ../../displaylist.rst:84 c199c76e0dfa41a280383ce1e166ecba +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 4c236de5436243ca9ac45bcfd79dddd3 +msgid ":ref:`TextPage`" +msgstr "" + +#: ../../displaylist.rst:87 717febbb734c4d7db4acd25302e696ed +msgid "text page of the display list." +msgstr "ディスプレイリストのテキストページ。" + +#: ../../displaylist.rst:91 203631a14dab4b89a4dcf052fb1276a1 +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 1bd53668f85347a8abce1224b19c85d6 +msgid "type" +msgstr "" + +#: ../../displaylist.rst:93 5edff22aa4f04a168a4aaf54e13b5575 +msgid ":ref:`Rect`" +msgstr "" + +#: ../../footer.rst:-1 cd0ba7210f4a44fbae8c8bafb17f468f +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/document-writer-class.mo b/docs/locales/ja/LC_MESSAGES/document-writer-class.mo new file mode 100644 index 000000000..51c856c14 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/document-writer-class.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/document-writer-class.po b/docs/locales/ja/LC_MESSAGES/document-writer-class.po new file mode 100644 index 000000000..ae6092168 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/document-writer-class.po @@ -0,0 +1,158 @@ +# 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" + +#: ../../document-writer-class.rst:7 cbf38e4bb22e4566b593acf5796202c2 +msgid "DocumentWriter" +msgstr "DocumentWriter(ドキュメントライター)" + +#: ../../document-writer-class.rst:9 39bca25367294b64a505506a068076f6 +msgid "New in v1.21.0" +msgstr "バージョン1.21.0で導入" + +#: ../../document-writer-class.rst:11 2008672db6ed4552944ed39c44d7f54a +msgid "" +"This class represents a utility which can output various :ref:`document " +"types supported by MuPDF`." +msgstr "このクラスは、MuPDFで :ref:`サポートされている ` さまざまなドキュメントタイプを出力できるユーティリティを表します。" + +#: ../../document-writer-class.rst:13 67174f48f7eb483085b9a7f7b6de32e2 +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:15 84a2e5e7e6e040b586a51598f95bb0f4 +msgid "" +"Using DocumentWriter_ also for other document types might happen in the " +"future." +msgstr "将来的には、DocumentWriter_ を他のドキュメントタイプにも使用することがあるかもしれません。" + +#: ../../document-writer-class.rst:18 6ef202c95694441dbf1f1a2259306008 +msgid "**Method / Attribute**" +msgstr "**メソッド/属性** " + +#: ../../document-writer-class.rst:18 0dca591225a64d768db303534ce240eb +msgid "**Short Description**" +msgstr "**簡単な説明** " + +#: ../../document-writer-class.rst:20 c93f6e572b294d5686db82c67a81f7fa +msgid ":meth:`DocumentWriter.begin_page`" +msgstr "" + +#: ../../document-writer-class.rst:20 37bbbc9a490043468ead7922aa81fd67 +msgid "start a new output page" +msgstr "新しい出力ページを開始します。" + +#: ../../document-writer-class.rst:21 718fcacf2d0f41ebaa54dfc75773a8eb +msgid ":meth:`DocumentWriter.end_page`" +msgstr "" + +#: ../../document-writer-class.rst:21 c9d52e40c1e34ab29f77500841232892 +msgid "finish the current output page" +msgstr "現在の出力ページを終了します。" + +#: ../../document-writer-class.rst:22 17fcbfd9d44e444f80141fec3ca3446b +msgid ":meth:`DocumentWriter.close`" +msgstr "" + +#: ../../document-writer-class.rst:22 651360fd253640418c8373b91b1f9230 +msgid "flush pending output and close the file" +msgstr "保留中の出力をフラッシュし、ファイルを閉じます。" + +#: ../../document-writer-class.rst:25 4b2f0b79a5984ebfb5b366c14662f19c +msgid "**Class API**" +msgstr "**クラスAPI** " + +#: ../../document-writer-class.rst:31 c39b184fb809475cb2912761f98aa8dc +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:33 bb82fb07fb664ed6a573a81477a4aec1 +msgid "This class can also be used as a Python context manager." +msgstr "このクラスはPythonのコンテキストマネージャとしても使用できます。" + +#: ../../document-writer-class.rst 402d3d379d334aef8e548db20ea6993e +#: 42209aa310cc42abbb06a0c3a04838f9 +msgid "Parameters" +msgstr "" + +#: ../../document-writer-class.rst:35 beec733beb8446909afbd4316f439975 +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:35 fe8e3dd6d0424f42bc0bbd7fb67490fb +msgid "" +"the output file. This may be a string file name, or any Python file " +"pointer." +msgstr "出力ファイル。これは文字列のファイル名またはPythonファイルポインタのいずれかです。" + +#: ../../document-writer-class.rst:37 eca55e1ec4354447bd021dc9739d233b +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:39 26daf331223e463b9743477b32b5b88a +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:43 cfdb8f539f104bbf9c775f41d947e346 +msgid "Start a new output page of a given dimension." +msgstr "指定された寸法の新しい出力ページを開始します。" + +#: ../../document-writer-class.rst:45 eaef6c9c016c4a77a1e77b565ce5861d +msgid "" +"a rectangle specifying the page size. After this method, output " +"operations may write content to the page." +msgstr "ページサイズを指定する矩形。このメソッドの後、出力操作はページにコンテンツを書き込むことができます。" + +#: ../../document-writer-class.rst:49 e7c3aec1923f4769b37faf5dfe343847 +msgid "" +"Finish a page. This flushes any pending data and appends the page to the " +"output document." +msgstr "ページを終了します。保留中のデータをフラッシュし、ページを出力ドキュメントに追加します。" + +#: ../../document-writer-class.rst:53 32544dee12684647a01c393b9d868c92 +msgid "" +"Close the output file. This method is required for writing any pending " +"data." +msgstr "出力ファイルを閉じます。保留中のデータを書き込むためにこのメソッドが必要です。" + +#: ../../document-writer-class.rst:55 b8ddc247f3a74143a49eea5486dc1ea3 +msgid "For usage examples consult the section of :ref:`Story`." +msgstr "使用例については、:ref:`Story` のセクションを参照してください。" + +#: ../../footer.rst:-1 41c36252bd0e4fc6914fb5e4edac4d19 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/document.mo b/docs/locales/ja/LC_MESSAGES/document.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/document.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/document.po b/docs/locales/ja/LC_MESSAGES/document.po new file mode 100644 index 000000000..bc870b0d1 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/document.po @@ -0,0 +1,5281 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../document.rst:7 1e2a5a64167f4a9898ee08390eca7534 +msgid "Document" +msgstr "" + +#: ../../document.rst:11 58ba1757a362440f8264db2e9c55b51e +msgid "" +"This class represents a document. It can be constructed from a file or " +"from memory." +msgstr "" + +#: ../../document.rst:13 7fb3c864334149af82d0e64482448cdb +msgid "" +"There exists the alias *open* for this class, i.e. `fitz.Document(...)` " +"and `fitz.open(...)` do exactly the same thing." +msgstr "" + +#: ../../document.rst:15 788e6122469d4b86b232a3ad7431b06c +msgid "For details on **embedded files** refer to Appendix 3." +msgstr "" + +#: ../../document.rst:19 8ff8b49798674a5b94cc13eb388c374e +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 "" + +#: ../../document.rst:21 c0e7b7fee7bd439abec54fafef56337e +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 "" + +#: ../../document.rst:23 ac1d136caec44a2e96e96ec7798999e1 +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 "" + +#: ../../document.rst:25 8ca1b67c0796450db915957d6aabc6e8 +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 1e69cd7e75e64a49a53c2b50360b0086 +msgid "**Method / Attribute**" +msgstr "" + +#: ../../document.rst:28 c7703a12491342de9d104106a7e4802c +msgid "**Short Description**" +msgstr "" + +#: ../../document.rst:30 e3063ce85a4a40abb08c89a09c37fe86 +msgid ":meth:`Document.add_layer`" +msgstr "" + +#: ../../document.rst:30 9c92b3559a9940188125c3be31ac1833 +msgid "PDF only: make new optional content configuration" +msgstr "" + +#: ../../document.rst:31 effe4cc45ab348f8b294877811b58af5 +msgid ":meth:`Document.add_ocg`" +msgstr "" + +#: ../../document.rst:31 12fc59019b2149b094b336f8cb66d907 +msgid "PDF only: add new optional content group" +msgstr "" + +#: ../../document.rst:32 3b8bf656c1234e5599266d54aae3172b +msgid ":meth:`Document.authenticate`" +msgstr "" + +#: ../../document.rst:32 33ee1808e31442e7943fa547151f5e5e +msgid "gain access to an encrypted document" +msgstr "" + +#: ../../document.rst:33 ec933d825a3d4a7da061ce55542544a9 +msgid ":meth:`Document.can_save_incrementally`" +msgstr "" + +#: ../../document.rst:33 e4d8332216034d62949c61fd3ea2bf72 +msgid "check if incremental save is possible" +msgstr "" + +#: ../../document.rst:34 22491857e93740f49ced67bf3f2387fe +msgid ":meth:`Document.chapter_page_count`" +msgstr "" + +#: ../../document.rst:34 0074679e8e674add8e14fa9d19e5e2d4 +msgid "number of pages in chapter" +msgstr "" + +#: ../../document.rst:35 58d9297c9b0c4fef80f3975d1b57bdff +msgid ":meth:`Document.close`" +msgstr "" + +#: ../../document.rst:35 4e3e89a2e49c4d38bf6e55b83b468ae1 +msgid "close the document" +msgstr "" + +#: ../../document.rst:36 dd0a765b42c741989ac7f243c6a767e5 +msgid ":meth:`Document.convert_to_pdf`" +msgstr "" + +#: ../../document.rst:36 04888a84203e4b209eae8afabb08330b +msgid "write a PDF version to memory" +msgstr "" + +#: ../../document.rst:37 840dd8abd20e46d3bd124e6874b43658 +msgid ":meth:`Document.copy_page`" +msgstr "" + +#: ../../document.rst:37 098d7d67f97a43c29cf3f12f1148a30b +msgid "PDF only: copy a page reference" +msgstr "" + +#: ../../document.rst:38 834d731fe13a4a9a96a2e972ca8e900c +msgid ":meth:`Document.del_toc_item`" +msgstr "" + +#: ../../document.rst:38 525ca2a352d24a04a35cb65b049ad523 +msgid "PDF only: remove a single TOC item" +msgstr "" + +#: ../../document.rst:39 b31c2c425a3e4dc5b74062f46c130c77 +msgid ":meth:`Document.delete_page`" +msgstr "" + +#: ../../document.rst:39 bb74860965a140eb8c9e6a59d5ceee39 +msgid "PDF only: delete a page" +msgstr "" + +#: ../../document.rst:40 09ceb9891b7f49a5bf38616892fb571b +msgid ":meth:`Document.delete_pages`" +msgstr "" + +#: ../../document.rst:40 0cd5643058f04e198e262ec6cdb3466f +msgid "PDF only: delete multiple pages" +msgstr "" + +#: ../../document.rst:41 e6f93076a2cb4dac97daf7fea2efaa9c +msgid ":meth:`Document.embfile_add`" +msgstr "" + +#: ../../document.rst:41 b9327aad2dff4930bf7508cfa3e5a193 +msgid "PDF only: add a new embedded file from buffer" +msgstr "" + +#: ../../document.rst:42 573a7ea6a0f04665a4d5dcfdb4e81400 +msgid ":meth:`Document.embfile_count`" +msgstr "" + +#: ../../document.rst:42 11856b4afb914855a649a222ff72908c +msgid "PDF only: number of embedded files" +msgstr "" + +#: ../../document.rst:43 9c5a470971a64a19b495b78a05a24b99 +msgid ":meth:`Document.embfile_del`" +msgstr "" + +#: ../../document.rst:43 4882518d2eac4440b17c2d4e62e71e46 +msgid "PDF only: delete an embedded file entry" +msgstr "" + +#: ../../document.rst:44 052d8559478a4c06b5f21c9ceb98a47d +msgid ":meth:`Document.embfile_get`" +msgstr "" + +#: ../../document.rst:44 a740c101ac1140ffbd9aca31d265d45c +msgid "PDF only: extract an embedded file buffer" +msgstr "" + +#: ../../document.rst:45 0b8f19a4db57453dbf6548c504be187d +msgid ":meth:`Document.embfile_info`" +msgstr "" + +#: ../../document.rst:45 9a4f6df66768421193ef7b792dc1fbdc +msgid "PDF only: metadata of an embedded file" +msgstr "" + +#: ../../document.rst:46 54152c52c98a41ec9d825315590b4cd2 +msgid ":meth:`Document.embfile_names`" +msgstr "" + +#: ../../document.rst:46 084ed06dc3064fd6964b97098256bb79 +msgid "PDF only: list of embedded files" +msgstr "" + +#: ../../document.rst:47 16dffe8be24240b699603849234f177b +msgid ":meth:`Document.embfile_upd`" +msgstr "" + +#: ../../document.rst:47 3a58b89ae43c4c15adfc5f23a1f8a816 +msgid "PDF only: change an embedded file" +msgstr "" + +#: ../../document.rst:48 da69dc9fcb34429d85c628e4a5a4ac95 +msgid ":meth:`Document.extract_font`" +msgstr "" + +#: ../../document.rst:48 a15e5b6778944634b0b19d70c0154852 +msgid "PDF only: extract a font by :data:`xref`" +msgstr "" + +#: ../../document.rst:49 62bcb1ff320f4099a6f5e0661bf6f343 +msgid ":meth:`Document.extract_image`" +msgstr "" + +#: ../../document.rst:49 4659f5ac403c4458acdc67ea4f983389 +msgid "PDF only: extract an embedded image by :data:`xref`" +msgstr "" + +#: ../../document.rst:50 83f9cdd69e0040299a09975ada3b396e +msgid ":meth:`Document.ez_save`" +msgstr "" + +#: ../../document.rst:50 421f79e0e6504e20a3e4544fffefdb0c +msgid "PDF only: :meth:`Document.save` with different defaults" +msgstr "" + +#: ../../document.rst:51 e6b230b9f5414f1480186c8e4475a373 +msgid ":meth:`Document.find_bookmark`" +msgstr "" + +#: ../../document.rst:51 193fb0afe93a4eba8e400ce961609246 +msgid "retrieve page location after laid out document" +msgstr "" + +#: ../../document.rst:52 c24a4a34d292486f87b51a633999d168 +msgid ":meth:`Document.fullcopy_page`" +msgstr "" + +#: ../../document.rst:52 a59c03ebcc7649f4aa981f473d3fb816 +msgid "PDF only: duplicate a page" +msgstr "" + +#: ../../document.rst:53 7ff826563fdf460b87f8d38461bf7930 +msgid ":meth:`Document.get_layer`" +msgstr "" + +#: ../../document.rst:53 f33604d1764147799bc640e427cb9e67 +msgid "PDF only: lists of OCGs in ON, OFF, RBGroups" +msgstr "" + +#: ../../document.rst:54 0899ab84c886498bb53b0f4f39454bcb +msgid ":meth:`Document.get_layers`" +msgstr "" + +#: ../../document.rst:54 a9fd5131e2c841bc97e364b9485a8712 +msgid "PDF only: list of optional content configurations" +msgstr "" + +#: ../../document.rst:55 019d63b5017a45108b0307a12b1679a8 +msgid ":meth:`Document.get_oc`" +msgstr "" + +#: ../../document.rst:55 9fee80a1647b4251ac8e066a52629e39 +msgid "PDF only: get OCG /OCMD xref of image / form xobject" +msgstr "" + +#: ../../document.rst:56 3da1b323bf104fe5866b811bd0f238fb +msgid ":meth:`Document.get_ocgs`" +msgstr "" + +#: ../../document.rst:56 170fe00d0bb944aaa60b70d0f649c373 +msgid "PDF only: info on all optional content groups" +msgstr "" + +#: ../../document.rst:57 ea6abe0041df4560bd3f1c533e0cdd63 +msgid ":meth:`Document.get_ocmd`" +msgstr "" + +#: ../../document.rst:57 dc8d6f739a0a48d781870acadda11045 +msgid "PDF only: retrieve definition of an :data:`OCMD`" +msgstr "" + +#: ../../document.rst:58 7ba79bdf5e57447d9767704430a99783 +msgid ":meth:`Document.get_page_fonts`" +msgstr "" + +#: ../../document.rst:58 2c100d900e7e4acbbe2d69def7a6a614 +msgid "PDF only: list of fonts referenced by a page" +msgstr "" + +#: ../../document.rst:59 26efaad2f95f4c879e60866243b70ed8 +msgid ":meth:`Document.get_page_images`" +msgstr "" + +#: ../../document.rst:59 5210f91a3ebf45aa82b604767496ab0f +msgid "PDF only: list of images referenced by a page" +msgstr "" + +#: ../../document.rst:60 02bbbf06e19c4e6d83429046127ed079 +msgid ":meth:`Document.get_page_labels`" +msgstr "" + +#: ../../document.rst:60 1b6793a3b337480aa2cc6b86870c6d10 +msgid "PDF only: list of page label definitions" +msgstr "" + +#: ../../document.rst:61 81ed6a84553f460980a1ceb9ec0069cc +msgid ":meth:`Document.get_page_numbers`" +msgstr "" + +#: ../../document.rst:61 c78a85b3f4b44bd19142898e027985d7 +msgid "PDF only: get page numbers having a given label" +msgstr "" + +#: ../../document.rst:62 479225d5ba81430b891404b79d51e85c +msgid ":meth:`Document.get_page_pixmap`" +msgstr "" + +#: ../../document.rst:62 7a27de8a5a314ed8b187a47c0e9f5ae9 +msgid "create a pixmap of a page by page number" +msgstr "" + +#: ../../document.rst:63 01da9151442b419eab7157ebeb32d284 +msgid ":meth:`Document.get_page_text`" +msgstr "" + +#: ../../document.rst:63 2e69e7f1d35546ae93874ceb25bfe051 +msgid "extract the text of a page by page number" +msgstr "" + +#: ../../document.rst:64 6c301d371cae4b2f882a8740a50e4d83 +msgid ":meth:`Document.get_page_xobjects`" +msgstr "" + +#: ../../document.rst:64 88f0a9abb0d2467aa42f9c19d5070061 +msgid "PDF only: list of XObjects referenced by a page" +msgstr "" + +#: ../../document.rst:65 86a0665f2a3a4579be1e19105c02698e +msgid ":meth:`Document.get_sigflags`" +msgstr "" + +#: ../../document.rst:65 4228e74b86b245f49a4deddb34a446d7 +msgid "PDF only: determine signature state" +msgstr "" + +#: ../../document.rst:66 53a1b2b9f7094755a874b0a1ad478c84 +msgid ":meth:`Document.get_toc`" +msgstr "" + +#: ../../document.rst:66 c32e06a5919646cb96d7e37522d51590 +msgid "extract the table of contents" +msgstr "" + +#: ../../document.rst:67 f20d8e4041ce4b7e8b245e2fc02d8396 +msgid ":meth:`Document.get_xml_metadata`" +msgstr "" + +#: ../../document.rst:67 da11dab5707a4c59bece6fdf9b686280 +msgid "PDF only: read the XML metadata" +msgstr "" + +#: ../../document.rst:68 cc5fd77dd38a43d0b8b5762f5e3e7a8c +msgid ":meth:`Document.has_annots`" +msgstr "" + +#: ../../document.rst:68 661281645e0c4da9883c871ae3be0035 +msgid "PDF only: check if PDF contains any annots" +msgstr "" + +#: ../../document.rst:69 5f8ad7c043604f55be380b15dca40797 +msgid ":meth:`Document.has_links`" +msgstr "" + +#: ../../document.rst:69 cc77a55e044b4aebaf7f9fe71bc5cfa0 +msgid "PDF only: check if PDF contains any links" +msgstr "" + +#: ../../document.rst:70 aa44f8eb69e049ba878e440f6daabc7b +msgid ":meth:`Document.insert_page`" +msgstr "" + +#: ../../document.rst:70 67b719e2bd9e4c8fb9e6e2d177d9f5a7 +msgid "PDF only: insert a new page" +msgstr "" + +#: ../../document.rst:71 f9cba04f5bc746d8a6287457d1d30cb7 +msgid ":meth:`Document.insert_pdf`" +msgstr "" + +#: ../../document.rst:71 ff53cafc159d4d7e8c515843bb57f50d +msgid "PDF only: insert pages from another PDF" +msgstr "" + +#: ../../document.rst:72 77859f7902354f03a8a40d0ef4fa5264 +msgid ":meth:`Document.insert_file`" +msgstr "" + +#: ../../document.rst:72 b48a13954c7e4df1999ef127df66fde9 +msgid "PDF only: insert pages from arbitrary document" +msgstr "" + +#: ../../document.rst:73 fbfa2027d3e34a11ac24e2198f79ca17 +msgid ":meth:`Document.journal_can_do`" +msgstr "" + +#: ../../document.rst:73 f904cd9105c9435bb8ba4d1e7bc0449e +msgid "PDF only: which journal actions are possible" +msgstr "" + +#: ../../document.rst:74 666adc4800134355a0b92a3d4046945d +msgid ":meth:`Document.journal_enable`" +msgstr "" + +#: ../../document.rst:74 b051780419064f8482e6cbc67cbc1e70 +msgid "PDF only: enables journalling for the document" +msgstr "" + +#: ../../document.rst:75 884b403857504209830fd3168ed762f2 +msgid ":meth:`Document.journal_load`" +msgstr "" + +#: ../../document.rst:75 a39c4ff60a1346b589c2b6c10ca9141f +msgid "PDF only: load journal from a file" +msgstr "" + +#: ../../document.rst:76 dfdc2f0c736547dc9abd816f695c4729 +msgid ":meth:`Document.journal_op_name`" +msgstr "" + +#: ../../document.rst:76 b58cefa3acb44291b30b926d4aec5aef +msgid "PDF only: return name of a journalling step" +msgstr "" + +#: ../../document.rst:77 8b116db0c314431294656136b6bfbe01 +msgid ":meth:`Document.journal_position`" +msgstr "" + +#: ../../document.rst:77 242dc4dc2e8d4c14943c9dc4b975cb2b +msgid "PDF only: return journalling status" +msgstr "" + +#: ../../document.rst:78 fdf2fb30684a481e842856f34a73e032 +msgid ":meth:`Document.journal_redo`" +msgstr "" + +#: ../../document.rst:78 79321859013f4b50a05e59092818a40b +msgid "PDF only: redo current operation" +msgstr "" + +#: ../../document.rst:79 9e5fe5167713472f969495bbabeed89a +msgid ":meth:`Document.journal_save`" +msgstr "" + +#: ../../document.rst:79 7ebadb98ce294cc0b2b90aae37e9c7d4 +msgid "PDF only: save journal to a file" +msgstr "" + +#: ../../document.rst:80 f3b529a2c74a421f9eb82dc7666138b0 +msgid ":meth:`Document.journal_start_op`" +msgstr "" + +#: ../../document.rst:80 9aa226d27a344610ad1aae1e5432b937 +msgid "PDF only: start an \"operation\" giving it a name" +msgstr "" + +#: ../../document.rst:81 bcfe8f55b8c54ec8a70063c8e4dbb990 +msgid ":meth:`Document.journal_stop_op`" +msgstr "" + +#: ../../document.rst:81 d87ea700c6f74f55bdee185aeccaad94 +msgid "PDF only: end current operation" +msgstr "" + +#: ../../document.rst:82 9b93352abdd04705a91e51b0645b63a0 +msgid ":meth:`Document.journal_undo`" +msgstr "" + +#: ../../document.rst:82 7011c1d7a0254279a6c7974df0296a97 +msgid "PDF only: undo current operation" +msgstr "" + +#: ../../document.rst:83 a08973895b83489aac61d8a847941b97 +msgid ":meth:`Document.layer_ui_configs`" +msgstr "" + +#: ../../document.rst:83 0109d735f4b94c2abc18e65a27922161 +msgid "PDF only: list of optional content intents" +msgstr "" + +#: ../../document.rst:84 663629a9805b40349fa6995585b00d45 +msgid ":meth:`Document.layout`" +msgstr "" + +#: ../../document.rst:84 70f45709e5874183ad352001c851dc92 +msgid "re-paginate the document (if supported)" +msgstr "" + +#: ../../document.rst:85 c241c20fbe4748ebbe3b9f0021af2936 +msgid ":meth:`Document.load_page`" +msgstr "" + +#: ../../document.rst:85 562403d6efcf4bc09a430c9c08e0b661 +msgid "read a page" +msgstr "" + +#: ../../document.rst:86 a67107abe2e14d9b8a764e3388a5f9b8 +msgid ":meth:`Document.make_bookmark`" +msgstr "" + +#: ../../document.rst:86 b77397ef4cc54755bf2c2f3e051e149f +msgid "create a page pointer in reflowable documents" +msgstr "" + +#: ../../document.rst:87 5cd40bd8f7c64655945e67368c22381b +msgid ":meth:`Document.move_page`" +msgstr "" + +#: ../../document.rst:87 7e7e8168fa5e4d128b623b5c03b3c126 +msgid "PDF only: move a page to different location in doc" +msgstr "" + +#: ../../document.rst:88 dddd6661c33e4d64806b15767e08171b +msgid ":meth:`Document.need_appearances`" +msgstr "" + +#: ../../document.rst:88 04ec0c4b372c4f7883302b6038c877d0 +msgid "PDF only: get/set `/NeedAppearances` property" +msgstr "" + +#: ../../document.rst:89 e5742c9eac9d4e2ebd0eff7c989f5266 +msgid ":meth:`Document.new_page`" +msgstr "" + +#: ../../document.rst:89 b0b5fa9f93e042018cc7ba8e8159dd9a +msgid "PDF only: insert a new empty page" +msgstr "" + +#: ../../document.rst:90 f594d3fe78144af6bc54097901251c8a +msgid ":meth:`Document.next_location`" +msgstr "" + +#: ../../document.rst:90 bafb3ecb2f294a6984fa90d9130854f7 +msgid "return (chapter, pno) of following page" +msgstr "" + +#: ../../document.rst:91 cb18938e3a1a4de7a4dc32eb535e289c +msgid ":meth:`Document.outline_xref`" +msgstr "" + +#: ../../document.rst:91 3a33742f72954a06905d2f5ca6fa53ce +msgid "PDF only: :data:`xref` a TOC item" +msgstr "" + +#: ../../document.rst:92 82485be6d6294e4889df0d082ae90d68 +msgid ":meth:`Document.page_cropbox`" +msgstr "" + +#: ../../document.rst:92 f4505653e57b4e10a3cdf221303b5df0 +msgid "PDF only: the unrotated page rectangle" +msgstr "" + +#: ../../document.rst:93 6899a83eb4a644ad971562199671eb61 +msgid ":meth:`Document.page_xref`" +msgstr "" + +#: ../../document.rst:93 610f55f793024d0aa2cba223bcfe5424 +msgid "PDF only: :data:`xref` of a page number" +msgstr "" + +#: ../../document.rst:94 6d404b2f2f6a49f185a5da82b7fde58a +msgid ":meth:`Document.pages`" +msgstr "" + +#: ../../document.rst:94 ac1fcc89658140328abddcfd595a00dc +msgid "iterator over a page range" +msgstr "" + +#: ../../document.rst:95 271a625473c34d4da77087d1702f7e14 +msgid ":meth:`Document.pdf_catalog`" +msgstr "" + +#: ../../document.rst:95 8a7c3d2322b3400a8a13e9badf4f5e26 +msgid "PDF only: :data:`xref` of catalog (root)" +msgstr "" + +#: ../../document.rst:96 58f3b11786c04037ba4c716554b67bb1 +msgid ":meth:`Document.pdf_trailer`" +msgstr "" + +#: ../../document.rst:96 d5ab6ddf1a3f4d6faea978e0225a4c60 +msgid "PDF only: trailer source" +msgstr "" + +#: ../../document.rst:97 5013ad53829e46fca40ee0812a4efb7e +msgid ":meth:`Document.prev_location`" +msgstr "" + +#: ../../document.rst:97 1f9662ae81a8481d8998aa3bf568b28c +msgid "return (chapter, pno) of preceding page" +msgstr "" + +#: ../../document.rst:98 09349b31fbbe41c382d9bd588fdc7b01 +msgid ":meth:`Document.reload_page`" +msgstr "" + +#: ../../document.rst:98 85335a88da0f44b0b3e82c229b94d7c9 +msgid "PDF only: provide a new copy of a page" +msgstr "" + +#: ../../document.rst:99 edf9b9a5f8164f18ba18c9216fb7ab0a +msgid ":meth:`Document.save`" +msgstr "" + +#: ../../document.rst:99 cede0e5084564615ad52d63f71edfdd3 +msgid "PDF only: save the document" +msgstr "" + +#: ../../document.rst:100 6739248c0cde4510a3c8987cd6625fc7 +msgid ":meth:`Document.saveIncr`" +msgstr "" + +#: ../../document.rst:100 55ddc46788a04182a38312566faa7027 +msgid "PDF only: save the document incrementally" +msgstr "" + +#: ../../document.rst:101 f68b0c7bfc3a456abded30a7cb9f3368 +msgid ":meth:`Document.scrub`" +msgstr "" + +#: ../../document.rst:101 805f8ec96a0f46c386266ca55146791e +msgid "PDF only: remove sensitive data" +msgstr "" + +#: ../../document.rst:102 8849fafb903548f28258a0057d6b05ac +msgid ":meth:`Document.search_page_for`" +msgstr "" + +#: ../../document.rst:102 dfc7dfdaf5e14f1da5f1aac430f62137 +msgid "search for a string on a page" +msgstr "" + +#: ../../document.rst:103 ff2e3d643c284d14bbd1cddabedf9839 +msgid ":meth:`Document.select`" +msgstr "" + +#: ../../document.rst:103 cf3f2c3122ff47b2bda33040a3a2d329 +msgid "PDF only: select a subset of pages" +msgstr "" + +#: ../../document.rst:104 298d96ade9384e57aba5ebe8261e489d +msgid ":meth:`Document.set_layer_ui_config`" +msgstr "" + +#: ../../document.rst:104 c545654d24eb4def8a24bd8868a4bcd4 +msgid "PDF only: set OCG visibility temporarily" +msgstr "" + +#: ../../document.rst:105 793489bd1ed14465bf003174e69819c9 +msgid ":meth:`Document.set_layer`" +msgstr "" + +#: ../../document.rst:105 4a29d419c24d4e03967c69bd83ffc7e6 +msgid "PDF only: mass changing OCG states" +msgstr "" + +#: ../../document.rst:106 69c6ca12eba94127b782a0b822485cfa +msgid ":meth:`Document.set_markinfo`" +msgstr "" + +#: ../../document.rst:106 8b0e52b3703f44d2972a2c2e51a20cae +msgid "PDF only: set the MarkInfo values" +msgstr "" + +#: ../../document.rst:107 21b48e00187445848b751390cea062ac +msgid ":meth:`Document.set_metadata`" +msgstr "" + +#: ../../document.rst:107 719a997e238a436b872eb3bea909e3d9 +msgid "PDF only: set the metadata" +msgstr "" + +#: ../../document.rst:108 72f15c1e9f3945b29245a888964b348c +msgid ":meth:`Document.set_oc`" +msgstr "" + +#: ../../document.rst:108 8eab34b1af7c40e6ab8a176f811ad926 +msgid "PDF only: attach OCG/OCMD to image / form xobject" +msgstr "" + +#: ../../document.rst:109 a0e3957f19324a1bb9b3eebba8b63846 +msgid ":meth:`Document.set_ocmd`" +msgstr "" + +#: ../../document.rst:109 97892a45b8af4c17a76ddebab016686a +msgid "PDF only: create or update an :data:`OCMD`" +msgstr "" + +#: ../../document.rst:110 b5def5bc670f43339b3574d02d810826 +msgid ":meth:`Document.set_page_labels`" +msgstr "" + +#: ../../document.rst:110 5735ba90591848488c3cd4b255645cca +msgid "PDF only: add/update page label definitions" +msgstr "" + +#: ../../document.rst:111 92e63d73650542cb81f7236cc239fb04 +msgid ":meth:`Document.set_pagemode`" +msgstr "" + +#: ../../document.rst:111 44d6f44d4014448db044d4916f753dfa +msgid "PDF only: set the PageMode" +msgstr "" + +#: ../../document.rst:112 185bddb0113847edb654494ddd1147a2 +msgid ":meth:`Document.set_pagelayout`" +msgstr "" + +#: ../../document.rst:112 bdb2698989954668bff79be65ef5e93b +msgid "PDF only: set the PageLayout" +msgstr "" + +#: ../../document.rst:113 73711b61acd745f2b80f5c8f87b72e16 +msgid ":meth:`Document.set_toc_item`" +msgstr "" + +#: ../../document.rst:113 443cebdf08be42dda544481ab7ae7c98 +msgid "PDF only: change a single TOC item" +msgstr "" + +#: ../../document.rst:114 08597b41acd74658b01630c67d72f47b +msgid ":meth:`Document.set_toc`" +msgstr "" + +#: ../../document.rst:114 1f31576a42f94fd4973c9c4f8297863f +msgid "PDF only: set the table of contents (TOC)" +msgstr "" + +#: ../../document.rst:115 11f4d8324e754a51bc0b7c3de24ef38f +msgid ":meth:`Document.set_xml_metadata`" +msgstr "" + +#: ../../document.rst:115 d67c3cbc10c247849acc1702be33995c +msgid "PDF only: create or update document XML metadata" +msgstr "" + +#: ../../document.rst:116 e0eb11dd3ab6455a9b02571adc95fc40 +msgid ":meth:`Document.subset_fonts`" +msgstr "" + +#: ../../document.rst:116 e47bc17674444a6aa961063e7ce0d7fb +msgid "PDF only: create font subsets" +msgstr "" + +#: ../../document.rst:117 b52e159ba49e45c2aea88a3e042353e5 +msgid ":meth:`Document.switch_layer`" +msgstr "" + +#: ../../document.rst:117 5331db565059412f90a0b2936b1a8a43 +msgid "PDF only: activate OC configuration" +msgstr "" + +#: ../../document.rst:118 bcc5cbb8d74e429f8ac5433b4bfec8c4 +msgid ":meth:`Document.tobytes`" +msgstr "" + +#: ../../document.rst:118 cb37e281ea2a42acb71a3a498ac466e7 +msgid "PDF only: writes document to memory" +msgstr "" + +#: ../../document.rst:119 86f985d0005244f1b201c46c467a3e97 +msgid ":meth:`Document.xref_copy`" +msgstr "" + +#: ../../document.rst:119 f1cc2cc94a4745fe8fe45a91e03dc026 +msgid "PDF only: copy a PDF dictionary to another :data:`xref`" +msgstr "" + +#: ../../document.rst:120 183501911b1247119e1582a1b28eadb6 +msgid ":meth:`Document.xref_get_key`" +msgstr "" + +#: ../../document.rst:120 e7496942b7374cedb4c29c5fe1ba6197 +msgid "PDF only: get the value of a dictionary key" +msgstr "" + +#: ../../document.rst:121 b7ff7c808b8a4d678c9a686d4881437b +msgid ":meth:`Document.xref_get_keys`" +msgstr "" + +#: ../../document.rst:121 0adcf81ba6fb42e38b06f5dd9f02e2e4 +msgid "PDF only: list the keys of object at :data:`xref`" +msgstr "" + +#: ../../document.rst:122 fe6f983453094988b4869f6417df3caf +msgid ":meth:`Document.xref_object`" +msgstr "" + +#: ../../document.rst:122 5f3c23b7b29349bc8924fa1affa0da2c +msgid "PDF only: get the definition source of :data:`xref`" +msgstr "" + +#: ../../document.rst:123 a52cfb027b7341498db60dd350b0d651 +msgid ":meth:`Document.xref_set_key`" +msgstr "" + +#: ../../document.rst:123 61e8aa37ad1e4af691f665cc39481842 +msgid "PDF only: set the value of a dictionary key" +msgstr "" + +#: ../../document.rst:124 69a0b2e662c8499dbfccf6313815464a +msgid ":meth:`Document.xref_stream_raw`" +msgstr "" + +#: ../../document.rst:124 2b01c72b3ccc4c059f22d1ed4455bbb4 +msgid "PDF only: raw stream source at :data:`xref`" +msgstr "" + +#: ../../document.rst:125 e17483881eb04b1b9b36c24acda7cef5 +msgid ":meth:`Document.xref_xml_metadata`" +msgstr "" + +#: ../../document.rst:125 4580eacd8c0949ef9e00c5fa93f3baa1 +msgid "PDF only: :data:`xref` of XML metadata" +msgstr "" + +#: ../../document.rst:126 599a47ae72fb4460aa4379bbd4f243e9 +msgid ":attr:`Document.chapter_count`" +msgstr "" + +#: ../../document.rst:126 eda521fde7484141bae7f416c678bc71 +msgid "number of chapters" +msgstr "" + +#: ../../document.rst:127 7ff455387eca488985b65d919142656e +msgid ":attr:`Document.FormFonts`" +msgstr "" + +#: ../../document.rst:127 26599db9896443c5b7c92e384d4dcc21 +msgid "PDF only: list of global widget fonts" +msgstr "" + +#: ../../document.rst:128 2749fc563b144860b0a2444acc9a1f70 +msgid ":attr:`Document.is_closed`" +msgstr "" + +#: ../../document.rst:128 1f440402e66e4902a6544e72f42c2414 +msgid "has document been closed?" +msgstr "" + +#: ../../document.rst:129 eda74498906f4e23be1394c10616ebbc +msgid ":attr:`Document.is_dirty`" +msgstr "" + +#: ../../document.rst:129 86cfaa8d0fa74aecb32229de921638ee +msgid "PDF only: has document been changed yet?" +msgstr "" + +#: ../../document.rst:130 57bed9df20d74305b1fa1938c3a05085 +msgid ":attr:`Document.is_encrypted`" +msgstr "" + +#: ../../document.rst:130 054330965d254e0ca88e10870997f60a +msgid "document (still) encrypted?" +msgstr "" + +#: ../../document.rst:131 a8b7f43aff504299b7fe07648e74d881 +msgid ":attr:`Document.is_fast_webaccess`" +msgstr "" + +#: ../../document.rst:131 b2974afe6f6b4fdc8ce0c53b4ad76b20 +msgid "is PDF linearized?" +msgstr "" + +#: ../../document.rst:132 4bf38f3d83de4377a66f7229895ddb6b +msgid ":attr:`Document.is_form_pdf`" +msgstr "" + +#: ../../document.rst:132 496b162c155245ad9536a21edd619f24 +msgid "is this a Form PDF?" +msgstr "" + +#: ../../document.rst:133 23be69e57c8d4a49a70ed05ecb9f4e6c +msgid ":attr:`Document.is_pdf`" +msgstr "" + +#: ../../document.rst:133 8b5e821881204f798977b42d03b72bd7 +msgid "is this a PDF?" +msgstr "" + +#: ../../document.rst:134 7b6554964cb44cf28d1659ff833f1536 +msgid ":attr:`Document.is_reflowable`" +msgstr "" + +#: ../../document.rst:134 818165dceba1469cb9dbf99cd6359407 +msgid "is this a reflowable document?" +msgstr "" + +#: ../../document.rst:135 3a918fb2d1d947bbb8f46fe0a92460cd +msgid ":attr:`Document.is_repaired`" +msgstr "" + +#: ../../document.rst:135 0abb6af1ed284bdc8861eaa1845d5bbd +msgid "PDF only: has this PDF been repaired during open?" +msgstr "" + +#: ../../document.rst:136 d2a9a75a86d94750a64df2e2e53bc49f +msgid ":attr:`Document.last_location`" +msgstr "" + +#: ../../document.rst:136 8b08715dd2cd4809a2250ac2495ffc39 +msgid "(chapter, pno) of last page" +msgstr "" + +#: ../../document.rst:137 71ec7a2f2fe54a03b9ab5cc0cad086c4 +msgid ":attr:`Document.metadata`" +msgstr "" + +#: ../../document.rst:137 ad6f1bdb43b04985ba8dc051dba82295 +msgid "metadata" +msgstr "" + +#: ../../document.rst:138 6b78f2f1bc5d45eeb1864bda981bbf49 +msgid ":attr:`Document.markinfo`" +msgstr "" + +#: ../../document.rst:138 4c688319b7e545218a392e4fb80a10f5 +msgid "PDF MarkInfo value" +msgstr "" + +#: ../../document.rst:139 05498faa56fe460cb721302ba11f8a89 +msgid ":attr:`Document.name`" +msgstr "" + +#: ../../document.rst:139 ee2657a24b1e4455afb39ed3960992ca +msgid "filename of document" +msgstr "" + +#: ../../document.rst:140 eb5ff720d65146849e32b667e7d0a13a +msgid ":attr:`Document.needs_pass`" +msgstr "" + +#: ../../document.rst:140 7907495cab88431fa032ed6b6080070d +msgid "require password to access data?" +msgstr "" + +#: ../../document.rst:141 b1e2dd38efc14816a540c6913bba6753 +msgid ":attr:`Document.outline`" +msgstr "" + +#: ../../document.rst:141 90eec173a9d64e24b9a0d7f06ca66edf +msgid "first `Outline` item" +msgstr "" + +#: ../../document.rst:142 05e115ca3e61493f815bff7c49c39de5 +msgid ":attr:`Document.page_count`" +msgstr "" + +#: ../../document.rst:142 c61c6c75a2284c41b3251c53d760307f +msgid "number of pages" +msgstr "" + +#: ../../document.rst:143 b888ba810dee4818b0f7ae18aa41154c +msgid ":attr:`Document.permissions`" +msgstr "" + +#: ../../document.rst:143 1f57361131894a3ba68401116cb82888 +msgid "permissions to access the document" +msgstr "" + +#: ../../document.rst:144 89618857d2f64699a4ea8a6afb3f6fc6 +msgid ":attr:`Document.pagemode`" +msgstr "" + +#: ../../document.rst:144 4b8e5500b9e740d38991ee42362bf618 +msgid "PDF PageMode value" +msgstr "" + +#: ../../document.rst:145 bffeca87aa33407b9275ae280a2896fa +msgid ":attr:`Document.pagelayout`" +msgstr "" + +#: ../../document.rst:145 06d16ff67e5a46d5a1856799fceae879 +msgid "PDF PageLayout value" +msgstr "" + +#: ../../document.rst:146 a692f65727724e3381ffbbb285018e2c +msgid ":attr:`Document.version_count`" +msgstr "" + +#: ../../document.rst:146 661656cafa9d46319cb96c690a4c4d17 +msgid "PDF count of versions" +msgstr "" + +#: ../../document.rst:149 c8ba6c0c38af47a39f7464ff17d0d639 +msgid "**Class API**" +msgstr "" + +#: ../../document.rst:170 6421dabd019641c6b59aa2094858d153 +msgid "Changed in v1.14.13: support `io.BytesIO` for memory documents." +msgstr "" + +#: ../../document.rst:171 ec7fb8c21637430986d490541cbb605d +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 "" + +#: ../../document.rst:173 e04cc017a38a449d92a13408f2c9a64e +msgid "Creates a *Document* object." +msgstr "" + +#: ../../document.rst:175 628ab38fe72045289c5684b3aff1c5d4 +msgid "With default parameters, a **new empty PDF** document will be created." +msgstr "" + +#: ../../document.rst:176 9a6875a48943490eaa96c0765e93fce3 +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 "" + +#: ../../document.rst:177 b81554f4aa5f441e823230039434acdb +msgid "" +"If *stream* is `None`, then a document is created from the file given by " +"*filename*. Its type is inferred from the extension. This can be " +"overruled by *filetype.*" +msgstr "" + +#: ../../document.rst 015bba15a5434845ba862e1d33cc1acc +#: 052f20e8e0e44d1a8ac6e259bd2a3c14 0be0a124ab6e4292a36f119b1e7c9325 +#: 0c61ef66b80449aea961640a2e4cebb3 10bb79b95e174c0289333355eeea8452 +#: 12cc22701a324300bf0bc4c1adfd1a47 13605e04c0864d2ba42676bea5c7c25a +#: 1816cbdad68d469b92e8c83ae6b67cc7 1bf3d9a4a00647a6ba271dbe41be294b +#: 202163a4dc9b4f72bc7cf5dc86b68460 244a8117ac434abc9874610bedeb3829 +#: 26f8aad4dfcb4ad2b92443c7ec3d7cb9 2a08fbd171a148199dd6c524171b52b6 +#: 2a8bce1407b14aec8307a56f323a643a 2ad2ea0fff244ed88f2ce7f322c9b94e +#: 34912c17d1034e9f99bfeda2326c8882 3dc60f49c9f443908fba0ee1650a8f0c +#: 40dfe071206f47b386c37f29c2b36bf5 4b20d6d5d8d148c18e8a2e65b71b868d +#: 4d76f9221ab34812951c1e9f51b80789 511ae24fb52949ab930cf8ce159a1125 +#: 52b9598f7183443ab0772d3308e8d308 53b0a12a6b0b4132afddaeebba9757d8 +#: 60417b547b2b4dae956d4d10ac4a4bf4 607dd4463d8446638aed8fb721da257c +#: 6caa1ebeafd849aebcc61d67a83551fa 6e19410f6d4c49baa178abd38cf54a19 +#: 72bfa49fd3c24afe994d926137417a9a 7ff140473b96419896c4f8c11d52e3ec +#: 804c84ef600c492191e6739dbc939f9d 81e3e81d85784160ad6d344eb85f5a47 +#: 8257c120eaa44f37affc66016a62a1ae 85936b3ab4eb45aaa66444f53d2fbd2f +#: 8a0dc2eed7e14ef2a1c90b61e93d40f1 8a222cdddf864323b45ff9b8be3987b8 +#: 8ceeedc5ace94444a62737f42f2ea926 90ef859e3f78427a94bdcf29a663d7ab +#: 948573a6fd2948e08ee6454623715926 9601f1e824114cd5aaa580f5bc6fb3ac +#: a276774a244248499616f35c24dd3e98 a5e97e13b70a42ee89905fb650f17e50 +#: a686a95d9d2a4c37909745097217abee abbe9b5aa8fc4a1fa3bf8014624431f9 +#: adc35eda86e745e49fa60b66c62fda90 addf5ab8dd12434d8bdfce03e4eed371 +#: aeadbdc3c89a471eb53d352b76c02d2f afe114d5b5aa410f8376884413cf084c +#: b145906c02e94772a0eb324dce52eca2 b5f86bef833141beb7ac2eff1e1a3c31 +#: bd0da6fc72ea4c25b6161e26d41146a7 c1bf50a086724d708d96f5ba7491d925 +#: c5cc524a67ba4cdc81701fedb89f1f9d c7452a755220410ba1df3673cb22020c +#: cc1e8bb598a447dfa7d03db17d6b9f97 ce7a80e0ccaa4a19ab8acda40b9d80be +#: ceb63a433f784796ac23c590a5243a0d d23c1ea584d94e7aa13bd51baed2bac0 +#: d29152f755b44b249bff4ef1a721db11 dcfd603bc8464d8dbdcb5ef319729bd5 +#: e35d6d3869934d5c81ec709e89a92d3a e571a2a679b8496a80ab86a6a798c9b5 +#: efb97839f21844989e19d4794820181c f0376fb741a64bff980ab4e8c8e6e40c +#: f249d3ecb25944fcade997a3356f3b03 f641a31ccc884820b26a2e920dd26b18 +#: f7071b66a3ba48faa6a814ced42a716f fb27ba22a9bf4a0089f862cb0357c08a +#: fc4148e05e4c4fdb92285860f00bdb61 +msgid "Parameters" +msgstr "" + +#: ../../document.rst:179 bc85521d3c164103b7246ecf54843804 +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 "" + +#: ../../document.rst:181 0d4e90006b3a45e4ba90af2a95ee85e5 +msgid "" +"A memory area containing a supported document. If not a PDF, its type " +"**must** be specified by either `filename` or `filetype`." +msgstr "" + +#: ../../document.rst:183 033cb00b8b8b4e2cb19a6b79043980dc +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 "" + +#: ../../document.rst:185 b48f6505652e41ce8a5be209adc5e0ca +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 *fontsize*, each page will be accordingly laid " +"out and hence also determine the number of pages." +msgstr "" + +#: ../../document.rst:187 84b1b11da9bf4a0789d6fe3c5cf25afd +msgid "" +"may used together with *height* as an alternative to *rect* to specify " +"layout information." +msgstr "" + +#: ../../document.rst:189 857acee400554df79d8fbfaa969bc4e7 +msgid "" +"may used together with *width* as an alternative to *rect* to specify " +"layout information." +msgstr "" + +#: ../../document.rst:191 b07ee600221e470899b75d365491c28b +msgid "" +"the default 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 "" + +#: ../../document.rst 2cbf413421504c63bd4573d702ea25ac +#: 3d6fc66c19e4404e8f0d88e1520b0286 +msgid "Raises" +msgstr "" + +#: ../../document.rst:193 a64429f6091d4a77a3b90bccf5dbdafd +msgid "if the *type* of any parameter does not conform." +msgstr "" + +#: ../../document.rst:194 2a3558878837455d9f79c84ea85faab6 +msgid "" +"if the file / path cannot be found. Re-implemented as subclass of " +"`RuntimeError`." +msgstr "" + +#: ../../document.rst:195 0f58dd2f56614f39b67c0ab20f477155 +msgid "" +"if the file / path is empty or the `bytes` object in memory has zero " +"length. A subclass of `FileDataError` and `RuntimeError`." +msgstr "" + +#: ../../document.rst:196 0a2a33f446ec48228dd2eb71f9767629 +msgid "if an unknown file type is explicitly specified." +msgstr "" + +#: ../../document.rst:197 2c2184a96f43492d89dcf30154d2acde +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 "" + +#: ../../document.rst 0a01696e83984a66bf4816059954f6ce +#: 0c68a2b789df44deae668a9b257419b0 151a90e53c3d4c40a10eaf35653a89b5 +#: 1627983e4e5748cab258b3de9433562d 1ddbb2cdbeb84430ae329bc3c5ee5d44 +#: 22ed40eb9ba14f41b842ebad06e63f7b 279b059d7af8411d9d00492713d1cbfd +#: 2f7883ed8a6244c2a768f29c3dad3e56 34f17de5594e4800a4179edb75ad8be1 +#: 4238dc60e2404a80a2725c346289ba26 452f346c45054a1e9d641b749f208781 +#: 4d68dbd19c8149d3ba09b8d591c0e087 4ecd38f58fb04403aed197ecc11a0576 +#: 50f458d741a84cd581d05bcddf0cfb5d 595182ea75d94fcf9d02d089f790ea43 +#: 5cf8accafbdc40eead3c8352ceda47b4 63491b880dcf456cb288557338646971 +#: 6496e8769d114f4083256aea822237f4 64f8e6918c2c4d5e996fd17e90283038 +#: 6692804345724d348dfcc570a71883e4 68d8a42dc6ac45b48960bb40ebef6268 +#: 72ae2741d1094ff99085aa41d1ead432 73567ea06c784d87a12efea095428d14 +#: 83a1396fde254601817a034cfbff6d34 845ca066e749404a9f80647436e063fa +#: 876da2fa871e4b9a9f9b3a705b43417e 89a607df5e1547eb8a93c9e2ba1f5c62 +#: 8ebc6327955f4bffb98aa915e18f5f07 97583ecc8f2b4192a0650850abb2a8d6 +#: 9bc7fb43a77f4145b7df456c7f699cdb a1f8e85d190b437fb5aad0f8f9eee91d +#: a79b4ebf43304dfeacaa58d69ca31b58 aa031047dcbf4782876a3cda2fcbbae6 +#: aaf4458c4be04e748342ccc97ab2309e abb2c3a8f70a48919ffeb47c37c35451 +#: abe9be1c326f430097ca1870744c8b2d b27a5bfc80c64e14bb4bd4a03beb1486 +#: b607abe32cf244528c71a5aa37d54950 c02f724a388149ab946c1a18e0a9a288 +#: d973c8fd1f714eaba8db851aa97467f2 dd4bc90f3cfd480a90a7e6c8b1a6fb57 +#: e833bcbbd762475d91ef163cb644fc38 f8741c55b57e45b1a9479964c9e8e1ba +msgid "Returns" +msgstr "" + +#: ../../document.rst:199 ad812ec84828477080e089494a5bfd65 +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(fitz.TOOLS.mupdf_warnings())` (which will be emptied by this call," +" but you can also prevent this -- consult :meth:`Tools.mupdf_warnings`)." +msgstr "" + +#: ../../document.rst:199 4f05c8d859cd49f28491fd83e6ea9686 +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 "" + +#: ../../document.rst:201 09d305b2c3974999a01482589ba93bbc +msgid "" +"In case of problems you can see more detail in the internal messages " +"store: `print(fitz.TOOLS.mupdf_warnings())` (which will be emptied by " +"this call, but you can also prevent this -- consult " +":meth:`Tools.mupdf_warnings`)." +msgstr "" + +#: ../../document.rst:203 49a59408c2154dfeb7a5bf91300211d8 +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 "" + +#: ../../document.rst:205 6793da59d507457e804f3e1f0f61f7ce +msgid "" +"HTM, HTML, XHTML: **always** opened, `metadata[\"format\"]` is \"HTML5\"," +" resp. \"XHTML\"." +msgstr "" + +#: ../../document.rst:206 4166d5b556594a9689447e0f2ceeae36 +msgid "XML, FB2: **always** opened, `metadata[\"format\"]` is \"FictionBook2\"." +msgstr "" + +#: ../../document.rst:208 8d0ead21d75945859a7e263fdaa41b5d +msgid "Overview of possible forms, note: `open` is a synonym of `Document`::" +msgstr "" + +#: ../../document.rst:225 e7aaa52081a9492f9a0247ea439c272d +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. " +"So `fitz.open(\"file.jpg\")` will work even for a PNG image." +msgstr "" + +#: ../../document.rst:227 09667dd74b5d4e84aa1c66e43b0d1cdf +msgid "" +"The Document class can be also be used as a **context manager**. On exit," +" the document will automatically be closed." +msgstr "" + +#: ../../document.rst:243 ../../document.rst:253 ../../document.rst:313 +#: ../../document.rst:359 0dc9b767c6be4a00992bbf094f48f6fa +#: 457bebf2f8eb4462824f0e49e44d14db 463ba691459f4e1eb074e43c7a114671 +#: 616d6fc062cd46d6bae9fd422ae0e043 +msgid "New in v1.18.4" +msgstr "" + +#: ../../document.rst:245 ae1a0acd1f6844b38c56fb9a7ddc922b +msgid "" +"Return the cross reference number of an :data:`OCG` or :data:`OCMD` " +"attached to an image or form xobject." +msgstr "" + +#: ../../document.rst:247 4f92de7f3e0149e78cc0638d022ba88f +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 "" + +#: ../../document.rst 025c32e516514cff9b375530fefd994c +#: 0b9b4727d83a40519b34792e1ec59393 0f5c02d6facd4bba86ac21b03611bd51 +#: 0ffdbfe9f9bb4cc4936996b8cf0bae31 1371779a83b24945b2c9f1504a853166 +#: 1d15c53d7bb547a4b93127003843c0c9 25ae2c95b28e498eb1e3be8021b6aa67 +#: 26c5129768a34b3da74c9921530c9c64 2b2fc30f039f4cf79951e2840074a5bb +#: 330764aaf07d492e92e153991c84c18e 353b92b5d6eb49e09b64c5b124b0a098 +#: 3dc4db1818ce4e369c2085961e563a86 3e5e5295448d425b82edefdf556c3710 +#: 3f920d8195eb4b4fb59a0163380c87d8 3f9fcaa9984841728618648f85662fe2 +#: 45cf683454af4436813a66813eee6590 59d78c4f45c54a8dbb4f61cb691f588f +#: 65c26ea0a114416daddff6bc4f23d8ab 69ac329fb2dd4dfea43ae3f108a82211 +#: 711240437fe545c885bbce0613ade023 7b25fb58ee234f10b48fa5c68d92970b +#: 841eff6fbdc74901af2a3afbdf14f7fd 8e073a4cc9064eba983b6f0388b3a467 +#: 92d185489d5a441ab3092a1b4ac1540d 9543444fe5044efe8a9b37909b3386ed +#: 98c0eccb475742d3b5600b34e3635073 9c5733236a7f41f39585cae13bd68480 +#: abcbc4353dc74733b910e5eb05a32ce5 c3c8477028ef44af96c3b5137e448a08 +#: ca6a228df71a4460ae431132c7d67aa7 ce56a7cc7598477994d1eeb0648ba9aa +#: d7a185dcdae3455bad4ed807719f4b33 dfb57b08402b402cbcf0b4796002d110 +#: ea6eb9f0fa1847da8b4a176de3d69c64 fbf6c2b5bbe04dd987b334b78e6cea86 +msgid "Return type" +msgstr "" + +#: ../../document.rst:249 201271e155f646c48228fa7f764e6dcb +msgid "" +"the cross reference number of an optional contents object or zero if " +"there is none." +msgstr "" + +#: ../../document.rst:255 24e47855789d4b22832f48dad05edfa6 +msgid "" +"If *xref* represents an image or form xobject, set or remove the cross " +"reference number *ocxref* of an optional contents object." +msgstr "" + +#: ../../document.rst:257 95b953bbced34952ba58d56b8000b139 +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 "" + +#: ../../document.rst:258 ea1f1f6639e64252863b8bdc61ce09c1 +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 "" + +#: ../../document.rst:263 ../../document.rst:273 ../../document.rst:284 +#: ../../document.rst:296 ../../document.rst:370 ../../document.rst:382 +#: ../../document.rst:404 ../../document.rst:422 ../../document.rst:438 +#: 0e5022e78b6f466ebc191b15af215bf3 12f4dcde388341ef9f3edd83bdc03b01 +#: 26ce146a82584484993e21f689eeeb57 2c4c4e41c1d9477981b3e7bb84ad9294 +#: 37e13348d8e344098c05a02cd6e18cbc 6c97d33d87434d6eb33eeaf0a9864058 +#: 8e3f60f4ea83460bb108e9076c6cd771 c43403237f984d1a93eb62034b6abf23 +#: db36811d5dbd4b24bd70bfefdc3dcf1c +msgid "New in v1.18.3" +msgstr "" + +#: ../../document.rst:265 905e03140b684387826140bd9d2b2ccd +msgid "" +"Show optional layer configurations. There always is a standard one, which" +" is not included in the response." +msgstr "" + +#: ../../document.rst:275 ef291c6df2a74d16a2981c77e7bdc543 +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 "" + +#: ../../document.rst:277 ba7decde4a8841c2bfde42060dc7fd24 +msgid "arbitrary name." +msgstr "" + +#: ../../document.rst:278 8d893e5a620a4ee38fcb50f637db2f9d +msgid "(optional) creating software." +msgstr "" + +#: ../../document.rst:279 801b744e63534028921d49eaaa2639ef +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 "" + +#: ../../document.rst:286 7bc3832def27477d8a3f3c9649240fdb +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:288 e7b23f661d4644b6bd36bdf43254b350 +msgid "config number as returned by :meth:`Document.layer_configs`." +msgstr "" + +#: ../../document.rst:289 67e637c5f5b64f8f93358f1b7a2b5ef2 +msgid "make this the default configuration." +msgstr "" + +#: ../../document.rst:291 7e7a3c94e54445e6b8bb8c4371ae1dc0 +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 "" + +#: ../../document.rst:298 f18b380dad1342569f9928bf491bf907 +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 "" + +#: ../../document.rst:300 6626168721b240e29d1c1411c9f76107 +msgid "arbitrary name. Will show up in supporting PDF viewers." +msgstr "" + +#: ../../document.rst:301 4ca300b43a16445993d89c2483d0e683 +msgid "layer configuration number. Default -1 is the standard configuration." +msgstr "" + +#: ../../document.rst:302 f9c95354271a49caba3a8e1eb5d6d77b +msgid "standard visibility status for objects pointing to this OCG." +msgstr "" + +#: ../../document.rst:303 0a5030acf6d9405f9993e0ff3f9a49ae +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 "" + +#: ../../document.rst:304 4d3432702ffc4573a1089bb912ea9b2f +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 "" + +#: ../../document.rst:306 eaa39863414e41319ce1a1eb0b5820ed +msgid "" +":data:`xref` of the created OCG. Use as entry for `oc` parameter in " +"supporting objects." +msgstr "" + +#: ../../document.rst:308 051b22d8ca4f403289d263e8a8836d8f +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 "" + +#: ../../document.rst:315 fb219c875d0e430f8a4181a357d25ff4 +msgid "" +"Create or update an :data:`OCMD`, **Optional Content Membership " +"Dictionary.**" +msgstr "" + +#: ../../document.rst:317 16ae12075a474b9fa663d442c515041d +msgid ":data:`xref` of the OCMD to be updated, or 0 for a new OCMD." +msgstr "" + +#: ../../document.rst:318 9e66a9475e3842c5b45713c9a533269b +msgid "a sequence of :data:`xref` numbers of existing :data:`OCG` PDF objects." +msgstr "" + +#: ../../document.rst:319 d0ecdd5f0d464146b9a3c9a95b5643cb +msgid "" +"one of \"AnyOn\" (default), \"AnyOff\", \"AllOn\", \"AllOff\" (mixed or " +"lower case)." +msgstr "" + +#: ../../document.rst:320 83c4a82605f24f44aeb7cd90ad04cfa0 +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 "" + +#: ../../document.rst:322 80b0326bd4b5406eb1c780b7acd5f370 +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 "" + +#: ../../document.rst:326 20202056dc3f45fbbfc5e84fb386c62e +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 "" + +#: ../../document.rst:328 6859a6c3e7d642a5b8c935e2571743d0 +msgid "There are two ways to formulate OCMD visibility:" +msgstr "" + +#: ../../document.rst:330 2e92b9d1cbd14b9694454ec35bc54dce +msgid "" +"Use the combination of *ocgs* and *policy*: The *policy* value is " +"interpreted as follows:" +msgstr "" + +#: ../../document.rst:332 ad796cb9127448989aa71139173ade2d +msgid "AnyOn -- (default) true if at least one OCG is ON." +msgstr "" + +#: ../../document.rst:333 b719d2748ed54ccfae5ebff22845cc2b +msgid "AnyOff -- true if at least one OCG is OFF." +msgstr "" + +#: ../../document.rst:334 6f0f05f038ca419893e7c720c96f1bd6 +msgid "AllOn -- true if all OCGs are ON." +msgstr "" + +#: ../../document.rst:335 b8f56f9f1edb4d6b8963005f11face2b +msgid "AllOff -- true if all OCGs are OFF." +msgstr "" + +#: ../../document.rst:337 dd49622d3bbb496db5ff3dba7b77c11c +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 "" + +#: ../../document.rst:339 bb6df99ff8d0490cadaecb849ca5c9b4 +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 "" + +#: ../../document.rst:341 5a707040dc704e32b277a03427e5f96e +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 "" + +#: ../../document.rst:343 ae428fbc1c4f413296eb8601684e6e5c +msgid "Each list must start with a logical keyword." +msgstr "" + +#: ../../document.rst:344 031fe6a1ff964477b55b20bf0acaa225 +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 "" + +#: ../../document.rst:345 48c3725b3e2543508e9d77949e2441c2 +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 "" + +#: ../../document.rst:347 4f956133abcf4422b97a339fd790d9fb +msgid "**Examples:**" +msgstr "" + +#: ../../document.rst:349 df78bd1b1c1a420cbfeb302c75cf60ff +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 "" + +#: ../../document.rst:350 4d35b319298c495fba3808befbed7e15 +msgid "" +"`set_ocmd(ve=[\"not\", xref])`. This has the same effect as the OCMD " +"example created under 1." +msgstr "" + +#: ../../document.rst:352 c40653210cc94949887f47f0ad22c51b +msgid "" +"For more details and examples see page 224 of :ref:`AdobeManual`. Also do" +" have a look at example scripts `here `_." +msgstr "" + +#: ../../document.rst:354 5d20a823b0084bf4bd0c227b7074e7e8 +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 "" + +#: ../../document.rst:361 30927a0a84aa4c87ae69607c1c92724b +msgid "Retrieve the definition of an :data:`OCMD`." +msgstr "" + +#: ../../document.rst:363 0ef70d3cd5514787a02ac2b147f13060 +msgid "the :data:`xref` of the OCMD." +msgstr "" + +#: ../../document.rst:365 f60d61b2dc9d4ebbbdeeffcedc20e5fb +msgid "a dictionary with the keys *xref*, *ocgs*, *policy* and *ve*." +msgstr "" + +#: ../../document.rst:372 d3a6482a5d2b4bbc93e7f2d74e108fd9 +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 "" + +#: ../../document.rst:374 a3dfc0668a2b4f8588a29fcc4e274c68 +msgid "the configuration layer (default is the standard config layer)." +msgstr "" + +#: ../../document.rst:384 1d0761238aab4e84aa16054c0fd31f82 +msgid "Changed in v1.22.5: Support list of *locked* OCGs." +msgstr "" + +#: ../../document.rst:386 026607a98a9043e1a461f0d1860b52c4 +msgid "" +"Mass status changes of optional content groups. **Permanently** sets the " +"status of OCGs." +msgstr "" + +#: ../../document.rst:388 5575f8cd01634d748af5028f38b6b534 +msgid "desired configuration layer, choose -1 for the default one." +msgstr "" + +#: ../../document.rst:389 d9b9d3b3e514470fad50ebf1bcfa4b9f +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 "" + +#: ../../document.rst:390 aeec402782ed4b50b1bc3020c6875e47 +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 "" + +#: ../../document.rst:391 66d0dfa9e33f44cc9f71862d2427a305 +msgid "" +"state of OCGs that are not mentioned in *on* or *off*. Possible values " +"are \"ON\", \"OFF\" or \"Unchanged\". Upper / lower case possible." +msgstr "" + +#: ../../document.rst:392 310ca981593e486385d0ab89eeaab961 +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 "" + +#: ../../document.rst:393 210692947fb3409698064cb4f440610e +msgid "a list of OCG xref number that cannot be changed by the user interface." +msgstr "" + +#: ../../document.rst:395 f364e7e9e746409d91a77fe3c5f9c1b9 +msgid "Values `None` will not change the corresponding PDF array." +msgstr "" + +#: ../../document.rst:406 0b94ed6c7a4f4386b69eee9f2aaab4e7 +msgid "" +"Details of all optional content groups. This is a dictionary of " +"dictionaries like this (key is the OCG's :data:`xref`):" +msgstr "" + +#: ../../document.rst:424 fb7eb8ee9e1040c8905456495bc25ba1 +msgid "" +"Show the visibility status of optional content that is modifiable by the " +"user interface of supporting PDF viewers." +msgstr "" + +#: ../../document.rst:426 2f04e8f4652d47c9b5bdae69fb47abaa +msgid "" +"Only reports items contained in the currently selected layer " +"configuration." +msgstr "" + +#: ../../document.rst:433 45869ad968d14d1e854da8a9301214b6 +msgid "The meaning of the dictionary keys is as follows:" +msgstr "" + +#: ../../document.rst:429 b5c7bac7c65a46ebbea1199cece5c194 +msgid "*depth:* item's nesting level in the `/Order` array" +msgstr "" + +#: ../../document.rst:430 4ac23944d3c042d6929aefa7e39f0a39 +msgid "*locked:* true if cannot be changed via user interfaces" +msgstr "" + +#: ../../document.rst:431 2055e4140942441aab1c49c1a5169a43 +msgid "*number:* running sequence number" +msgstr "" + +#: ../../document.rst:432 e04510d06b8942958738c0e8bf5571e9 +msgid "*on:* item state" +msgstr "" + +#: ../../document.rst:433 a784c55c4d654437a4da3ca29a54c8c0 +msgid "*text:* text string or name field of the originating OCG" +msgstr "" + +#: ../../document.rst:434 9f642034b4e545ffa098b00b47a0a675 +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 "" + +#: ../../document.rst:440 0b6a78799049464bbb550e9268dcf83d +msgid "" +"Modify OC visibility status of content groups. This is analog to what " +"supporting PDF viewers would offer." +msgstr "" + +#: ../../document.rst:442 b954c31ab37d4762a47ce18812af0b6d +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 "" + +#: ../../document.rst:444 b23e97247d34442aa2f2518bd2dd2a76 +msgid "To make **permanent** changes, use :meth:`Document.set_layer`." +msgstr "" + +#: ../../document.rst:446 9f14d7d760fa479290e1b55e5964fa19 +msgid "" +"either the sequence number of the item in list " +":meth:`Document.layer_configs` or the \"text\" of one of these items." +msgstr "" + +#: ../../document.rst:447 2f0344ea63134ce6aaf4efd20a0ea477 +msgid "" +"`PDF_OC_ON` = set on (default), `PDF_OC_TOGGLE` = toggle on/off, " +"`PDF_OC_OFF` = set off." +msgstr "" + +#: ../../document.rst:452 978bcd5fb6d5446687853a01d7da5cee +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 "" + +#: ../../document.rst:454 7a180c2fd09f48938b006b0d595b47de +msgid "owner or user password." +msgstr "" + +#: ../../document.rst:457 162babc6f795496c8d6acdb9243009df +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:457 dec301046f83456990405616f2a09da5 +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 "" + +#: ../../document.rst:459 bec1b0425f8b42a5850e8b05ec10fdf7 +msgid "1 => authenticated, but the PDF has neither owner nor user passwords." +msgstr "" + +#: ../../document.rst:460 ed69dbef500b4d9a82bb811feb37d5aa +msgid "2 => authenticated with the **user** password." +msgstr "" + +#: ../../document.rst:461 6ea6ccf3da5048108fd78c1c3f8d7e68 +msgid "4 => authenticated with the **owner** password." +msgstr "" + +#: ../../document.rst:462 20b0fcbe089449e48f7297bf6b5dc3f9 +msgid "" +"6 => authenticated and both passwords are equal -- probably a rare " +"situation." +msgstr "" + +#: ../../document.rst:466 4f962bddfdb241c68057e00ea10bcfb3 +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 "" + +#: ../../document.rst:470 220cb6a59839442194116c87ced483f6 +msgid "New in v 1.18.6" +msgstr "" + +#: ../../document.rst:472 37ec34a2b82b4ad498889f345eef54b3 +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 "" + +#: ../../document.rst:474 b87316439cd34b6d90fbfc9b55c23c09 +msgid "Implementation detail -- pages are **not loaded** for this purpose." +msgstr "" + +#: ../../document.rst:476 d1cd68e82b0242ff80221e04cd6b7a6d +msgid "the label to look for, e.g. \"vii\" (Roman number 7)." +msgstr "" + +#: ../../document.rst:477 599a41725f3c482e86fbd134a9050be3 +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:479 1c798c94653947b696839065bd4fc506 +msgid "" +"list of page numbers that have this label. Empty if none found, no labels" +" defined, etc." +msgstr "" + +#: ../../document.rst:484 ../../document.rst:728 ../../document.rst:749 +#: ../../document.rst:1733 0f55a2af62fd441eac6ab5424e58c27d +#: 3aa9515e2c7b4642a8db065079848673 47a60deb9b194ea5b7fc267a9761ce96 +#: 795fe56d6b9a44039cb14f9b8f094f4c +msgid "New in v1.18.7" +msgstr "" + +#: ../../document.rst:486 3bd91c0749104da09a14d20eecd010a9 +msgid "" +"PDF only: Extract the list of page label definitions. Typically used for " +"modifications before feeding it into :meth:`Document.set_page_labels`." +msgstr "" + +#: ../../document.rst:488 a9771de9befc4a17a5dd88a9a7536bfc +msgid "a list of dictionaries as defined in :meth:`Document.set_page_labels`." +msgstr "" + +#: ../../document.rst:492 f509921a567949008d0ba14b3d68474f +msgid "New in v1.18.6" +msgstr "" + +#: ../../document.rst:494 665ee2f8d21b40b5b895e5623fa3e02d +msgid "PDF only: Add or update the page label definitions of the PDF." +msgstr "" + +#: ../../document.rst:496 a85485ebf815483d9ebf6939c2f90ba8 +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:496 998e97d61345484386640ca8bdd4bf41 +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 "" + +#: ../../document.rst:498 b1e629c272d04b1095550c6a738c018b +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 "" + +#: ../../document.rst:499 c1e4370ff5e54f7abe6cd345dedc77dc +msgid "" +"`prefix`: (str) an arbitrary string to start the label with, e.g. \"A-\"." +" Default is \"\"." +msgstr "" + +#: ../../document.rst:500 9408fa6c2bd4429b8da1d3af6b54d13b +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 "" + +#: ../../document.rst:501 37e6ebeaea1140759a53a81b163d5272 +msgid "" +"`firstpagenum`: (int) start numbering with this value. Default is 1, " +"smaller values are ignored." +msgstr "" + +#: ../../document.rst:503 15cd6559c5de428c89d94441ca16f88f +msgid "For example::" +msgstr "" + +#: ../../document.rst:508 539e18f72bab4035bcbcbe390e0c862d +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 "" + +#: ../../document.rst:513 ../../document.rst:527 +#: 3a464db30b264007906c7c942d779a4b df95714486b64d4aa93ee909d6d771ce +msgid "New in v.1.17.3" +msgstr "" + +#: ../../document.rst:515 daa10b07bf534620ae1975f1a584c780 +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:517 4c330070897049b4b50b38361e04d710 +msgid "Do not confuse with items of a table of contents, TOC." +msgstr "" + +#: ../../document.rst:519 c899e28b42774f2384d2aa8834f085b8 +msgid "page location. Must be a valid *(chapter, pno)*." +msgstr "" + +#: ../../document.rst:522 a46a7f656f9d47108fb8b10292d39c33 +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:529 4507e266e3594a6c9577a99c13a615f1 +msgid "Return the new page location after re-layouting the document." +msgstr "" + +#: ../../document.rst:531 f799c1b551b34006970a4782155183d0 +msgid "created by :meth:`Document.make_bookmark`." +msgstr "" + +#: ../../document.rst:534 ea35ad20c8af422aa32b8b806e36c0a6 +msgid "the new (chapter, pno) of the page." +msgstr "" + +#: ../../document.rst:539 ../../document.rst:551 ../../document.rst:562 +#: 4a099649e5924e6eaeadb861cdd7fe2a 6b3f627fdd2c4543aff406695fe5b6af +#: b933b577ad0b4238925c42a8787ff752 +msgid "New in v.1.17.0" +msgstr "" + +#: ../../document.rst:541 0916c3d7648b47b4bd45255526e3527e +msgid "Return the number of pages of a chapter." +msgstr "" + +#: ../../document.rst:543 d4091f3c0fad4f4e92a4c502c1851c75 +msgid "the 0-based chapter number." +msgstr "" + +#: ../../document.rst:546 f6c56e236e6b407bac95e9d0024067c8 +msgid "" +"number of pages in chapter. Relevant only for document types with chapter" +" support (EPUB currently)." +msgstr "" + +#: ../../document.rst:553 6b9cdc6488ff4520b5cc7088436fb675 +msgid "Return the location of the following page." +msgstr "" + +#: ../../document.rst:555 ../../document.rst:566 +#: 2ceb1241c1bd4d7d8ead124d2c136c6c e81a8bc34eb54b00bad3d4a29cc75e4d +msgid "" +"the current page id. This must be a tuple *(chapter, pno)* identifying an" +" existing page." +msgstr "" + +#: ../../document.rst:557 8abf89cd9fc64e8f96ef70db9f0e7132 +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 "" + +#: ../../document.rst:564 bdd3e97cdcd84b6988a237a15ad20c0a +msgid "Return the locator of the preceding page." +msgstr "" + +#: ../../document.rst:568 4033c6cbeddb4eb281c9f7c61daa7842 +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 "" + +#: ../../document.rst:573 3f0530a1866f42cd966c639ab201f99e +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 "" + +#: ../../document.rst:575 0e2c159fae3045839bfa0664046c035e +msgid "" +"Create a :ref:`Page` object for further processing (like rendering, text " +"searching, etc.)." +msgstr "" + +#: ../../document.rst:577 30b4e64b45e2405fa210140502c0c102 +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:577 54e94dd328ed4c91809f8b5f624f5636 +msgid "*(Changed in v1.17.0)*" +msgstr "" + +#: ../../document.rst:579 99257123023c4e9ea4505465c6adef0f +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 "" + +#: ../../document.rst:581 45dfbe026a2448498b65bb638b72a19d +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 "" + +#: ../../document.rst:583 ../../document.rst:604 ../../document.rst:1286 +#: 4a968175f18b40f990d81f4b723ae0e3 71f43473e71c48a2a65d6d80bfd7a687 +#: f730fc8cc5ce412083b9f2919e0ca00d +msgid ":ref:`Page`" +msgstr "" + +#: ../../document.rst:587 010d3d0cbf1b4d4ab9e643c6da87ea79 +msgid "" +"Documents also follow the Python sequence protocol with page numbers as " +"indices: *doc.load_page(n) == doc[n]*." +msgstr "" + +#: ../../document.rst:589 92e12592ebeb4a7cb3a5865247e0bc70 +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 "" + +#: ../../document.rst:591 86d99eda024841bf907abbde410df174 +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 "" + +#: ../../document.rst:593 2b82f7e5b9fa460faac994a21fe681fc +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 "" + +#: ../../document.rst:597 f4850e39130d4053be9b39b394bb4e0f +msgid "New in v1.16.10" +msgstr "" + +#: ../../document.rst:599 cb74db08e8074d7e85cce63fb0ca4672 +msgid "" +"PDF only: Provide a new copy of a page after finishing and updating all " +"pending changes." +msgstr "" + +#: ../../document.rst:601 c5297433cc6c43a680920a911f488453 +msgid "page object." +msgstr "" + +#: ../../document.rst:606 ec2c8fb58a044531855808d7550a004a +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:606 17f905b4c56c4cc6806a00a9b7c37ea7 +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:608 f16311dcd80a4e03a735c8e2967789a6 +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 "" + +#: ../../document.rst:613 ../../document.rst:623 ../../document.rst:1043 +#: ../../document.rst:1053 ../../document.rst:1065 +#: 1ad214d3086d44128918e1f277bea91e 209300f610184ffa903610d4fef554ed +#: 428c54084c0d4e2f9802f48e0daf9fab a7854a4f9358496ca21bd6782acc56b4 +#: d852e438f91f4617a0b96cd5aac3554b +msgid "New in v1.17.7" +msgstr "" + +#: ../../document.rst:615 1d42642d17654db0b7e40e53f4fc9b60 +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 "" + +#: ../../document.rst:617 ../../document.rst:627 +#: 09fb4e4f96b249b99bea976cc8b7f577 94bf4f1dfb1d413aad5e03f569ca6b60 +msgid "0-based page number." +msgstr "" + +#: ../../document.rst:619 ff6da7dfc0a34e29b0c5cb752e2c0f13 +msgid ":ref:`Rect` of the page like :meth:`Page.rect`, but ignoring any rotation." +msgstr "" + +#: ../../document.rst:625 f4e56c2fcc084f2ea5c10c0388e86427 +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 "" + +#: ../../document.rst:629 1e42c994f2d442629c975360a7072b73 +msgid ":data:`xref` of the page like :attr:`Page.xref`." +msgstr "" + +#: ../../document.rst:633 513b6ae54bd1401aa1a14ef8de326adc +msgid "New in v1.16.4" +msgstr "" + +#: ../../document.rst:635 d58c9a594f444b93ac6374085c3455e8 +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 "" + +#: ../../document.rst:637 ba715521ac0b4b7fbe9efa838624e254 +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 "" + +#: ../../document.rst:638 5d748c9139ed4b9a8a6fd96fca78def0 +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 "" + +#: ../../document.rst:639 411404aa3a1d4879be5f8f0369411cb8 +msgid "" +"stepping value. Defaults are 1 if start < stop and -1 if start > stop. " +"Zero is not allowed." +msgstr "" + +#: ../../document.rst:641 027398bd9070438e8c7c851ffe7f55da +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:641 8afc02e60b59429487a2f63d59229a84 +msgid "a generator iterator over the document's pages. Some examples:" +msgstr "" + +#: ../../document.rst:643 766eb8356ed046699ef91ce40370a0a0 +msgid "\"doc.pages()\" emits all pages." +msgstr "" + +#: ../../document.rst:644 3a61225131264f68bd4e0cd06bcb6703 +msgid "\"doc.pages(4, 9, 2)\" emits pages 4, 6, 8." +msgstr "" + +#: ../../document.rst:645 1bef2ff221e94030b96bc4fd8cbc3adf +msgid "\"doc.pages(0, None, 2)\" emits all pages with even numbers." +msgstr "" + +#: ../../document.rst:646 eb41828efd3d40e28083c64bce119af4 +msgid "\"doc.pages(-2)\" emits the last two pages." +msgstr "" + +#: ../../document.rst:647 ca57fd4711f34d66b4067025c51502fb +msgid "\"doc.pages(-1, -1)\" emits all pages in reversed order." +msgstr "" + +#: ../../document.rst:648 6c192406ae5d4e85a0e42b650f833acf +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 "" + +#: ../../document.rst:657 b5de3ef6d28d4214a75d05fedc1634da +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 "" + +#: ../../document.rst:659 746a3a300691432f91fcff1b2e1e020a +msgid "first page to copy (0-based). Default is first page." +msgstr "" + +#: ../../document.rst:661 8f691d0c812c441abc4c026c48decddf +msgid "last page to copy (0-based). Default is last page." +msgstr "" + +#: ../../document.rst:663 ff6f28bf2f5d44baa831e24414ee5077 +msgid "" +"rotation angle. Default is 0 (no rotation). Should be *n * 90* with an " +"integer n (not checked)." +msgstr "" + +#: ../../document.rst:666 79d48c7d70f7465aad170c6d292a577d +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 = " +"fitz.open(\"some.xps\") >>> pdfbytes = xps.convert_to_pdf() >>> >>> # " +"either do this --> >>> pdf = fitz.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 = fitz.open() # new PDF" +" >>> imglist = [ ... image file names ...] # e.g. a directory listing >>>" +" for img in imglist: imgdoc=fitz.open(img) # open image" +" as a document pdfbytes=imgdoc.convert_to_pdf() # make a 1-page " +"PDF of it imgpdf=fitz.open(\"pdf\", pdfbytes) " +"doc.insert_pdf(imgpdf) # insert the image PDF >>> " +"doc.save(\"allmyimages.pdf\")" +msgstr "" + +#: ../../document.rst:666 5d767de566a34791a799ce91fa03d1fb +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 "" + +#: ../../document.rst:692 0a024d1d00e547b4a31b0083316792c4 +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 "" + +#: ../../document.rst:694 8897e2f4a2a649819f2d57ed5cccf493 +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 "" + +#: ../../document.rst:695 e5ccc14012164e6db1a808fee5c51058 +msgid "" +"XPS: appearance very good. Links work fine, outlines (bookmarks) are " +"lost, but can easily be recovered [#f2]_." +msgstr "" + +#: ../../document.rst:696 2dead1263376420a8e0e0d51189a9ad3 +msgid "EPUB, CBZ, FB2: similar to XPS." +msgstr "" + +#: ../../document.rst:697 1a0577c0df2448d8b8001ec031f98006 +msgid "" +"SVG: medium. Roughly comparable to `svglib " +"`_." +msgstr "" + +#: ../../document.rst:701 67ec053fc4c64741a90b32593a97d00d +msgid "Creates a table of contents (TOC) out of the document's outline chain." +msgstr "" + +#: ../../document.rst:703 330b7bd350734a049d63b9403d123b43 +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 "" + +#: ../../document.rst:707 e0b60ff0063a43fead122aca6add6828 +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 "" + +#: ../../document.rst:707 b9ffb73c9f86467e97605ebf57ed1ea7 +msgid "" +"a list of lists. Each entry has the form *[lvl, title, page, dest]*. Its " +"entries have the following meanings:" +msgstr "" + +#: ../../document.rst:709 2e7d663ad095487f906ecd45a5077410 +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 "" + +#: ../../document.rst:710 2239cb9d8d874b0eb18f6a1c1d81f7ef +msgid "*title* -- title (*str*)" +msgstr "" + +#: ../../document.rst:711 2ddde9610188455ca9b053bdd7a9e056 +msgid "" +"*page* -- 1-based page number (*int*). If `-1` either no destination or " +"outside document." +msgstr "" + +#: ../../document.rst:712 eb297ae5f58541b594221852e1b50bd7 +msgid "" +"*dest* -- (*dict*) included only if *simple=False*. Contains details of " +"the TOC item as follows:" +msgstr "" + +#: ../../document.rst:714 0bce7e4fcbe44863ba9b125ae48612a4 +msgid "kind: destination kind, see :ref:`linkDest Kinds`." +msgstr "" + +#: ../../document.rst:715 8b8213e1136f4d2fb590f7b9278254d5 +msgid "file: filename if kind is :data:`LINK_GOTOR` or :data:`LINK_LAUNCH`." +msgstr "" + +#: ../../document.rst:716 c2393960170844a0ac4307fd1b5f2765 +msgid "page: target page, 0-based, :data:`LINK_GOTOR` or :data:`LINK_GOTO` only." +msgstr "" + +#: ../../document.rst:717 591fa360c9b744a98438e1dd959db54d +msgid "to: position on target page (:ref:`Point`)." +msgstr "" + +#: ../../document.rst:718 d4b8537e626540e0829758c3bbb912db +msgid "zoom: (float) zoom factor on target page." +msgstr "" + +#: ../../document.rst:719 cdec9fd70dd14a2992d8259f63222fe0 +msgid "xref: :data:`xref` of the item (0 if no PDF)." +msgstr "" + +#: ../../document.rst:720 e9f2cdab2a664a4ababd1ff7f1ce24d1 +msgid "" +"color: item color in PDF RGB format `(red, green, blue)`, or omitted " +"(always omitted if no PDF)." +msgstr "" + +#: ../../document.rst:721 b08ba88d5d9344d8b7e289961d0ff0d5 +msgid "bold: true if bold item text or omitted. PDF only." +msgstr "" + +#: ../../document.rst:722 7c4cc6302f6f4c65bc2ffa1e91349f74 +msgid "italic: true if italic item text, or omitted. PDF only." +msgstr "" + +#: ../../document.rst:723 08f0833e25bd423eaead437ac2ddcf9b +msgid "collapse: true if sub-items are folded, or omitted. PDF only." +msgstr "" + +#: ../../document.rst:730 8b97ef01b48d4f2c8b38719b8caa000c +msgid "" +"PDF only: Return the PDF dictionary keys of the :data:`dictionary` object" +" provided by its xref number." +msgstr "" + +#: ../../document.rst:732 3703b31e15844e9d986b528ba06cba1c +msgid "" +"the :data:`xref`. *(Changed in v1.18.10)* Use `-1` to access the special " +"dictionary \"PDF trailer\"." +msgstr "" + +#: ../../document.rst:734 55a224e59fe3447680ca6cece1d97300 +msgid "" +"a tuple of dictionary keys present in object :data:`xref`. Examples: >>>" +" from pprint import pprint >>> import fitz >>> " +"doc=fitz.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:734 4699a76751eb419bba5e1f68ae3ddec3 +msgid "a tuple of dictionary keys present in object :data:`xref`. Examples:" +msgstr "" + +#: ../../document.rst:751 86622e8b57f1456b973da5f5de21b72a +msgid "" +"PDF only: Return type and value of a PDF dictionary key of a " +":data:`dictionary` object given by its xref." +msgstr "" + +#: ../../document.rst:753 d43a9a284f364159bebd6b533e043f2e +msgid "" +"the :data:`xref`. *Changed in v1.18.10:* Use `-1` to access the special " +"dictionary \"PDF trailer\"." +msgstr "" + +#: ../../document.rst:755 28e51fbb171840b19cf6fa8e897291e7 +msgid "" +"the desired PDF key. Must **exactly** match (case-sensitive) one of the " +"keys contained in :meth:`Document.xref_get_keys`." +msgstr "" + +#: ../../document.rst:759 84d7abc76fb3495eb5c0203b1f75b1b4 +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 "" + +#: ../../document.rst:761 2a7765335c9f4f73b06cf6f8e92ae724 +msgid "A \"name\" always starts with a \"/\" slash." +msgstr "" + +#: ../../document.rst:762 e266f2dabcfa457e876b6e0635184620 +msgid "An \"xref\" always ends with \" 0 R\"." +msgstr "" + +#: ../../document.rst:763 cd564700513748d4b5293700b6b7b89f +msgid "An \"array\" is always enclosed in \"[...]\" brackets." +msgstr "" + +#: ../../document.rst:764 a2b166a635414bdd98a4026a04929872 +msgid "A \"dict\" is always enclosed in \"<<...>>\" brackets." +msgstr "" + +#: ../../document.rst:765 0a8425fcadf94de081e768088ca6371f +msgid "" +"A \"bool\", resp. \"null\" always equal either \"true\", \"false\", resp." +" \"null\"." +msgstr "" + +#: ../../document.rst:766 be0b432516444eb2970a33f99b97e1ff +msgid "" +"\"float\" and \"int\" are represented by their string format -- and are " +"thus not always distinguishable." +msgstr "" + +#: ../../document.rst:767 f12cb3b7686c4d65973362d2d84b9139 +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 "" + +#: ../../document.rst:796 72edac04520f46e08289ad9cf2cb4aa6 +msgid "New in v1.18.7, changed in v 1.18.13" +msgstr "" + +#: ../../document.rst:797 a282f8d865864fd2a956208d8f295afc +msgid "Changed in v1.19.4: remove a key \"physically\" if set to \"null\"." +msgstr "" + +#: ../../document.rst:799 6180b6f6521d490db00119cdc34bc6f3 +msgid "" +"PDF only: Set (add, update, delete) the value of a PDF key for the " +":data:`dictionary` object given by its xref." +msgstr "" + +#: ../../document.rst:801 3fca2db4ff9a483ead8e9951a023fe7a +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 "" + +#: ../../document.rst:803 0a23af545f46473d86cfd5c10322ef66 +msgid "" +"the :data:`xref`. *Changed in v1.18.13:* To update the PDF trailer, " +"specify -1." +msgstr "" + +#: ../../document.rst:804 6f3a1dbe41e04b27abfa101687bf91c9 +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 "" + +#: ../../document.rst:805 387b6fbe43ca4473ac565646225e2a97 +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 "" + +#: ../../document.rst:807 300c41bf958b46bb8ab67d925f3a9bdf +msgid "" +"**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 "" + +#: ../../document.rst:808 1ce8024abfef47298382fece7c584105 +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 "" + +#: ../../document.rst:809 b11b59f5a35e45ce98a9cec9b07344f4 +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 "" + +#: ../../document.rst:810 1df54c22588645bcaecf0638f501b354 +msgid "**int** -- an integer formatted **as a string**." +msgstr "" + +#: ../../document.rst:811 f9bd162fa1d945cb8b342bce99657575 +msgid "" +"**float** -- a float formatted **as a string**. Scientific notation (with" +" exponents) is **not allowed by PDF**." +msgstr "" + +#: ../../document.rst:812 92c2fa9f2b894c0aa2ac939ba4a9a82c +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 "" + +#: ../../document.rst:813 136d4feccc284235b2fc9bfa93541f51 +msgid "**bool** -- one of the strings `\"true\"` or `\"false\"`." +msgstr "" + +#: ../../document.rst:814 18c4421b9c724e7ba795d6ab831be045 +msgid "" +"**name** -- a valid PDF name with a leading slash like this: " +"`\"/PageLayout\"`. See page 16 of the :ref:`AdobeManual`." +msgstr "" + +#: ../../document.rst:815 34b98e12b8714cc6bb6f8d67ff6c2652 +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 "" + +#: ../../document.rst:817 41af587732084295805868ad10ba73ea +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 "" + +#: ../../document.rst:818 0169627c10064b7ba177c916de58ac89 +msgid "" +"\"<...>\" for hex-encoded text. Every character must be represented by " +"two hex-digits (lower or upper case)." +msgstr "" + +#: ../../document.rst:820 7d2902688294428e9de3b95956cb9b7a +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 "" + +#: ../../document.rst:832 f296e989f0bb4420a10c5adf58c797ab +msgid "" +"Creates a pixmap from page *pno* (zero-based). Invokes " +":meth:`Page.get_pixmap`." +msgstr "" + +#: ../../document.rst:834 00af5fa1ac744a46a9cfe8515fa69c5a +msgid "All parameters except `pno` are *keyword-only.*" +msgstr "" + +#: ../../document.rst:836 3afeb8ceee8d49a280213d789d47184f +msgid "page number, 0-based in `-∞ < pno < page_count`." +msgstr "" + +#: ../../document.rst:838 38114a07b80c457fb66031a2dc1bcb93 +msgid ":ref:`Pixmap`" +msgstr "" + +#: ../../document.rst:842 38fd757294064607aeed50ea97fb9fd7 +msgid "New in v1.16.13" +msgstr "" + +#: ../../document.rst:843 cf1beb74091a415b945b98285d04dfe2 +msgid "Changed in v1.18.11" +msgstr "" + +#: ../../document.rst:845 f89a71b0850e46b9b607362cd051622c +msgid "PDF only: Return a list of all XObjects referenced by a page." +msgstr "" + +#: ../../document.rst:847 ../../document.rst:862 ../../document.rst:890 +#: 83e80e078ed9480bbc98bcbfa9961b30 a8038787249649048729834854763ffd +#: ae2424fb2e2645fb8dfdcd26efeb3f94 +msgid "page number, 0-based, `-∞ < pno < page_count`." +msgstr "" + +#: ../../document.rst:850 dc98a64da13048eca53137b97c28e278 +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" +" * **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:850 f8a5335b91a34bb99b48bd84fe9fa197 +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 "" + +#: ../../document.rst:852 4cdf771cd816437c9f090608770a1d75 +msgid "**xref** (*int*) is the XObject's :data:`xref`." +msgstr "" + +#: ../../document.rst:853 b04a777530d54a42a0f704a2161d399c +msgid "**name** (*str*) is the symbolic name to reference the XObject." +msgstr "" + +#: ../../document.rst:854 0487b1fd5c304e409ea1e2bc23ee4485 +msgid "" +"**invoker** (*int*) the :data:`xref` of the invoking XObject or zero if " +"the page directly invokes it." +msgstr "" + +#: ../../document.rst:855 5afb60a8aef245d39a13d09e8fb313b5 +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 "" + +#: ../../document.rst:860 9e2ed16536b940a5b0f8dad62b4ddf26 +msgid "" +"PDF only: Return a list of all images (directly or indirectly) referenced" +" by the page." +msgstr "" + +#: ../../document.rst:863 68d280ecc6b64f5a8a3e51c70fe9be78 +msgid "" +"whether to also include the referencer's :data:`xref` (which is zero if " +"this is the page)." +msgstr "" + +#: ../../document.rst:867 dd526df3c28648e6935d02a8de8eda79 +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 * **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 "" + +#: ../../document.rst:867 4324d199cc624862b4fcd8927eccc083 +msgid "a list of images **referenced** by this page. Each item looks like" +msgstr "" + +#: ../../document.rst:869 acb16b27b4df4a028ae7cbdd4a9c1069 +msgid "" +"`(xref, smask, width, height, bpc, colorspace, alt. colorspace, name, " +"filter, referencer)`" +msgstr "" + +#: ../../document.rst:871 1fea474ffa59469ab68d20e0b6746ab3 +msgid "Where" +msgstr "" + +#: ../../document.rst:873 5afe5ec55bbb45c497e87b6d0a10c5e3 +msgid "**xref** (*int*) is the image object number" +msgstr "" + +#: ../../document.rst:874 5df6cec0e38c4c8e9cb03143411ab60c +msgid "**smask** (*int*) is the object number of its soft-mask image" +msgstr "" + +#: ../../document.rst:875 b3bd88c522674435942d1f5e6c2c8940 +msgid "**width** and **height** (*ints*) are the image dimensions" +msgstr "" + +#: ../../document.rst:876 bf0fb9b0353e4fc0aaf09a87488d05a8 +msgid "**bpc** (*int*) denotes the number of bits per component (normally 8)" +msgstr "" + +#: ../../document.rst:877 80d07de7dd0f445bb881bd110c9c4283 +msgid "**colorspace** (*str*) a string naming the colorspace (like **DeviceRGB**)" +msgstr "" + +#: ../../document.rst:878 b19a70fe29374274b2ff174f63cdc8d6 +msgid "" +"**alt. colorspace** (*str*) is any alternate colorspace depending on the " +"value of **colorspace**" +msgstr "" + +#: ../../document.rst:879 efd04a7d6f4b440f96257347d3da8095 +msgid "**name** (*str*) is the symbolic name by which the image is referenced" +msgstr "" + +#: ../../document.rst:880 a0ab31c9681447a080dbfe59c1619586 +msgid "" +"**filter** (*str*) is the decode filter of the image (:ref:`AdobeManual`," +" pp. 22)." +msgstr "" + +#: ../../document.rst:881 2dd6c1eb323d42ba9679fc1baaae1003 +msgid "" +"**referencer** (*int*) the :data:`xref` of the referencer. Zero if " +"directly referenced by the page. Only present if *full=True*." +msgstr "" + +#: ../../document.rst:883 66989033e8f740eb8c9735b1f8c45b38 +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 "" + +#: ../../document.rst:888 7ee24c1877bd4854853afa55264524b0 +msgid "" +"PDF only: Return a list of all fonts (directly or indirectly) referenced " +"by the page." +msgstr "" + +#: ../../document.rst:891 46211694988c4513ae0aa21dcf8b4a19 +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 "" + +#: ../../document.rst:895 6a1c0dc449804818b69d556d1075a435 +msgid "a list of fonts referenced by this page. Each entry looks like" +msgstr "" + +#: ../../document.rst:897 0f5c62bef33a4456ab1606b92067e8dd +msgid "**(xref, ext, type, basefont, name, encoding, referencer)**," +msgstr "" + +#: ../../document.rst:899 c68fd6fd5eff49399a788d6f3997c697 +msgid "where" +msgstr "" + +#: ../../document.rst:901 9f267b6e5d0d473cbd6d5058c18fb1b9 +msgid "" +"**xref** (*int*) is the font object number (may be zero if the PDF uses " +"one of the builtin fonts directly)" +msgstr "" + +#: ../../document.rst:902 fe053fef6c6c43afb85d3708f77a003f +msgid "" +"**ext** (*str*) font file extension (e.g. \"ttf\", see " +":ref:`FontExtensions`)" +msgstr "" + +#: ../../document.rst:903 b34b7cf60d8e4efc904d3aa321aaee0f +msgid "**type** (*str*) is the font type (like \"Type1\" or \"TrueType\" etc.)" +msgstr "" + +#: ../../document.rst:904 248d1bafe773484e9dce5146e9cef4f0 +msgid "**basefont** (*str*) is the base font name," +msgstr "" + +#: ../../document.rst:905 380f2f42684c4dfc99ea0d02a361b890 +msgid "**name** (*str*) is the symbolic name, by which the font is referenced" +msgstr "" + +#: ../../document.rst:906 942db33e538046999a61fb915bf5539e +msgid "" +"**encoding** (*str*) the font's character encoding if different from its " +"built-in encoding (:ref:`AdobeManual`, p. 254):" +msgstr "" + +#: ../../document.rst:907 35db9f8e4c724a0ebaf4f17c859e036d +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 "" + +#: ../../document.rst:909 867c02d4b41b4723a27ca065704d71bc +msgid "Example::" +msgstr "" + +#: ../../document.rst:922 76e6019e889d45c5b812843a556ba938 +msgid "" +"This list has no duplicate entries: the combination of :data:`xref`, " +"*name* and *referencer* is unique." +msgstr "" + +#: ../../document.rst:923 ecac21e0bde74da5bcc2655466ecaf32 +msgid "" +"In general, this is a 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 only makes partial use." +msgstr "" + +#: ../../document.rst:927 248b871c039e47b5a261ade10750ad61 +msgid "" +"Extracts the text of a page given its page number *pno* (zero-based). " +"Invokes :meth:`Page.get_text`." +msgstr "" + +#: ../../document.rst:929 9ad2bbfcb1a04530975bdb2263ce836d +msgid "page number, 0-based, any value `-∞ < pno < page_count`." +msgstr "" + +#: ../../document.rst:931 c41424877bf6472e978e9c894c89551c +msgid "For other parameter refer to the page method." +msgstr "" + +#: ../../document.rst:943 a99e6c20bfc14d9db6cc7683cec92d34 +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 "" + +#: ../../document.rst:945 32fdaced27484ae48ac47bb359d49aec +msgid "desired page size. Must be finite, not empty and start at point (0, 0)." +msgstr "" + +#: ../../document.rst:946 bf991878899c4aae8256ddf4fa2cd978 +msgid "use it together with *height* as alternative to *rect*." +msgstr "" + +#: ../../document.rst:947 b1f42251694a47e49b1555423a31de25 +msgid "use it together with *width* as alternative to *rect*." +msgstr "" + +#: ../../document.rst:948 b281a88bc749466e8335ba5f9002f914 +msgid "the desired default fontsize." +msgstr "" + +#: ../../document.rst:952 d54d740a754d48a88a9ef9d38f72c1d0 +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 "" + +#: ../../document.rst:954 969209b6f6824c0eb48673bb8f2bb209 +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 "" + +#: ../../document.rst:958 11def9a9343e4b96ab05c3fb0cd50ed7 +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:960 d5bdabd37d4246d1ac840ce5add159fa +msgid "" +"On a technical level, the method will always create a new " +":data:`pagetree`." +msgstr "" + +#: ../../document.rst:962 f02e316e978240fe88732e3860bd6109 +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 "" + +#: ../../document.rst:967 ab1bc833df75412b849d00ba8e615555 +msgid "" +"PDF only: Sets or updates the metadata of the document as specified in " +"*m*, a Python dictionary." +msgstr "" + +#: ../../document.rst:969 af3cdcca45544c46b6256450626d4a12 +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 "" + +#: ../../document.rst:971 43435761fc0845908ed40a3358aad409 +msgid "" +"*(Changed in v1.18.4)* Empty values or \"none\" are no longer written, " +"but completely omitted." +msgstr "" + +#: ../../document.rst:975 a96d5b27f7124a9ba80b5ac99bc21717 +msgid "PDF only: Get the document XML metadata." +msgstr "" + +#: ../../document.rst:978 87408e9f907e4ad59cb170d537dfa3c9 +msgid "XML metadata of the document. Empty string if not present or not a PDF." +msgstr "" + +#: ../../document.rst:982 a18f443ab384493aaacf4cc5216523f8 +msgid "PDF only: Sets or updates XML metadata of the document." +msgstr "" + +#: ../../document.rst:984 03ac61c133894af6ac9a8755ce99f768 +msgid "" +"the new XML metadata. Should be XML syntax, however no checking is done " +"by this method and any string is accepted." +msgstr "" + +#: ../../document.rst:989 ../../document.rst:998 ../../document.rst:1007 +#: ../../document.rst:1889 ../../document.rst:1897 ../../document.rst:1905 +#: ../../document.rst:1913 ../../document.rst:1921 +#: 1364ce56382b480d8dc4b36927b5ada0 2998b5dc060e49bcab73edcd9496cd3d +#: 44649cb6e9394bf2816537db6b16ec1b 55f1c5ee70fc4f7eb4d34b9e9b9fdfc5 +#: 6eed5eee173c4dd0b62df7b1d445da4d 7236996724894a2396a9b12f2ab114cd +#: b21f484919ab493ab77d49ffe9640556 f277ee1cd5db4ec1836d73c94a59a5e4 +msgid "New in v1.22.2" +msgstr "" + +#: ../../document.rst:991 733981bbff5940e99e3534eb096ab195 +msgid "PDF only: Set the `/PageLayout`." +msgstr "" + +#: ../../document.rst:993 0ffc898db19443a6a1691c38bb5f9135 +msgid "" +"one of the strings \"SinglePage\", \"OneColumn\", \"TwoColumnLeft\", " +"\"TwoColumnRight\", \"TwoPageLeft\", \"TwoPageRight\". Lower case is " +"supported." +msgstr "" + +#: ../../document.rst:1000 d911ef02767648ef9d81f36ecada9f34 +msgid "PDF only: Set the `/PageMode`." +msgstr "" + +#: ../../document.rst:1002 bc24989da77f4f4388759a5bd44014be +msgid "" +"one of the strings \"UseNone\", \"UseOutlines\", \"UseThumbs\", " +"\"FullScreen\", \"UseOC\", \"UseAttachments\". Lower case is supported." +msgstr "" + +#: ../../document.rst:1009 e230aa6a70024e96a0adf847cc11db08 +msgid "PDF only: Set the `/MarkInfo` values." +msgstr "" + +#: ../../document.rst:1011 c30833a78fb34c1d8cc3fa7140baeac4 +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 "" + +#: ../../document.rst:1016 adbc4ffac0f440fab3de5391b8f4e25b +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 "" + +#: ../../document.rst:1018 e7538640f77142adb96d93312971004d +msgid "Step 1 deletes all existing bookmarks." +msgstr "" + +#: ../../document.rst:1020 25ed6297df3c4ffb8588e41e8731db10 +msgid "Step 2 creates a new TOC from the entries contained in *toc*." +msgstr "" + +#: ../../document.rst:1022 e42bf1e15fb847dcbb316e1b60caa6f2 +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:1024 26086b1ff13d426b9f2bbd2ae843a27c +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 "" + +#: ../../document.rst:1026 c03c1234fb4c40cbbe3a4a6161660e41 +msgid "[lvl, title, page [, dest]] where" +msgstr "" + +#: ../../document.rst:1028 721c19fa409d4894a1e8a9b19e9be22b +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 "" + +#: ../../document.rst:1030 a17f283db2a443d390f2eafdc59141f4 +msgid "" +"**title** (str) is the title to be displayed. It is assumed to be " +"UTF-8-encoded (relevant for multibyte code points only)." +msgstr "" + +#: ../../document.rst:1032 6b10e910e98a4b4fa291b24c7c8ee7b7 +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 "" + +#: ../../document.rst:1034 f77a9ea0760a4671b11ef6d19348f9b9 +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 "" + +#: ../../document.rst:1036 5b46e02f2c54479b8e00302efa64f990 +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 "" + +#: ../../document.rst:1039 0679c4eada374dd997c9e661cd2a58a8 +msgid "the number of inserted, resp. deleted items." +msgstr "" + +#: ../../document.rst:1045 c2a812449f964110b28d1c543c0dea19 +msgid "" +"PDF only: Return the :data:`xref` of the outline item. This is mainly " +"used for internal purposes." +msgstr "" + +#: ../../document.rst:1047 b659c81b761f4db4a0d5ba0536d335b1 +msgid "arg int idx: index of the item in list :meth:`Document.get_toc`." +msgstr "" + +#: ../../document.rst:1049 3a675aa36e8f4bdaa202dd46fef46aa0 +msgid ":data:`xref`." +msgstr "" + +#: ../../document.rst:1054 9ae15090c10c418f93594ae8e3aad302 +msgid "" +"Changed in v1.18.14: no longer remove the item's text, but show it " +"grayed-out." +msgstr "" + +#: ../../document.rst:1056 57552527d92740408dc663d702d6ef0c +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 "" + +#: ../../document.rst:1058 1da262438d294404b253756d02595c40 +msgid "" +"This also implies that you can reassign the item to a new destination " +"using :meth:`Document.set_toc_item`, when required." +msgstr "" + +#: ../../document.rst:1060 ef570fab433448fc92aaead2ff350ec3 +msgid "the index of the item in list :meth:`Document.get_toc`." +msgstr "" + +#: ../../document.rst:1066 c1c8f702412a49a294501c569a859c21 +msgid "Changed in v1.18.6" +msgstr "" + +#: ../../document.rst:1068 fd09d98d699e423dadf30fd355003640 +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 "" + +#: ../../document.rst:1070 18c48e6de39b4070ba459c2ec3daaffb +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 "" + +#: ../../document.rst:1072 ff9ac1d76f944ec686c6417d14f22208 +msgid "the index of the entry in the list created by :meth:`Document.get_toc`." +msgstr "" + +#: ../../document.rst:1073 5d4f4d81ec864b37a29561b6a906f113 +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 "" + +#: ../../document.rst:1074 b35288482ecc46afbdcae341efa73dec +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 "" + +#: ../../document.rst:1075 5a6381dded454a3a81dd08ec39cbd70f +msgid "" +"the 1-based page number, i.e. a value 1 <= pno <= doc.page_count. " +"Required for LINK_GOTO." +msgstr "" + +#: ../../document.rst:1076 4c69020454494811819bd8b75350d165 +msgid "the URL text. Required for LINK_URI." +msgstr "" + +#: ../../document.rst:1077 763ead03445945eeb36393a2e719674b +msgid "the desired new title. None if no change." +msgstr "" + +#: ../../document.rst:1078 b74b01c7927248a181e0297d0ff2eb87 +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 "" + +#: ../../document.rst:1079 37521ee56f40407498f163d583d8a9ed +msgid "required for LINK_GOTOR and LINK_LAUNCH." +msgstr "" + +#: ../../document.rst:1080 e71c8539b59d4ef3b45159c03d7fe8c8 +msgid "use this zoom factor when showing the target page." +msgstr "" + +#: ../../document.rst:1082 7fceb2a77ca04341a1c9f272340d9404 +msgid "**Example use:** Change the TOC of the SWIG manual to achieve this:" +msgstr "" + +#: ../../document.rst:1084 53f2853ad4c14853802d94d1ced31897 +msgid "" +"Collapse everything below top level and show the chapter on Python " +"support in red, bold and italic::" +msgstr "" + +#: ../../document.rst:1101 d9a4471e44b142eab7589ba8b5c9d7f5 +msgid "" +"In the previous example, we have changed only 42 of the 1240 TOC items of" +" the file." +msgstr "" + +#: ../../document.rst:1105 20ce4cb6430a482ca8f7b994d0eb97be +msgid "New in v1.16.0" +msgstr "" + +#: ../../document.rst:1107 1afd79adfc6045259405d99e7028f64d +msgid "" +"Check whether the document can be saved incrementally. Use it to choose " +"the right option without encountering exceptions." +msgstr "" + +#: ../../document.rst:1111 35e8cfd511764c61b0a2808724c380e5 +msgid "New in v1.16.14" +msgstr "" + +#: ../../document.rst:1113 c757cee022ff4e04bfbfccb33146697f +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 "" + +#: ../../document.rst:1115 89234b6fc9a14bd0bcc0f76804a25d24 +msgid "Search for 'FileAttachment' annotations and remove the file content." +msgstr "" + +#: ../../document.rst:1116 ad16cc5a49f9438d82b9c9d7b9a33df3 +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 "" + +#: ../../document.rst:1117 97de2f97f3514f6d887f52af6cfc50d4 +msgid "Remove embedded files." +msgstr "" + +#: ../../document.rst:1118 09bd7ebd47cc48d496ef9682e51f4bd9 +msgid "Remove OCRed text and invisible text [#f7]_." +msgstr "" + +#: ../../document.rst:1119 32775818e21e4816b5ec94873c2c493d +msgid "Remove JavaScript sources." +msgstr "" + +#: ../../document.rst:1120 c5af7adbdefe4e3b850cb9b90f38c2ad +msgid "Remove PDF standard metadata." +msgstr "" + +#: ../../document.rst:1121 057bd3c04d9f4d12a070c9ee7d7f832a +msgid "Apply redaction annotations." +msgstr "" + +#: ../../document.rst:1122 9c36be176f894409b4bce6e4cb3d9ec2 +msgid "" +"how to handle images if applying redactions. One of 0 (ignore), 1 (blank " +"out overlaps) or 2 (remove)." +msgstr "" + +#: ../../document.rst:1123 6f3b702b35d64ade9d87cdb9366adda6 +msgid "Remove all links." +msgstr "" + +#: ../../document.rst:1124 83d0b055056d49ac8e887b502f546c11 +msgid "Reset all form fields to their defaults." +msgstr "" + +#: ../../document.rst:1125 a95729d78694476eaf482468e8ae7b55 +msgid "Remove all responses from all annotations." +msgstr "" + +#: ../../document.rst:1126 2d758fed639c4d7ea1d8102aadc43b66 +msgid "Remove thumbnail images from pages." +msgstr "" + +#: ../../document.rst:1127 cffa6e73cae14bf9aff32dfd60f220fb +msgid "Remove XML metadata." +msgstr "" + +#: ../../document.rst:1132 ../../document.rst:1197 +#: 3f880652bcca4b0cabc7401011397c95 c3e189e02dcd4fea878daa34c49c292b +msgid "Changed in v1.18.7" +msgstr "" + +#: ../../document.rst:1133 ../../document.rst:1198 +#: 3130ac74858d42078113f2d728b69563 d0c03612a3254bd2802b44753b5c7882 +msgid "Changed in v1.19.0" +msgstr "" + +#: ../../document.rst:1135 6c91429b7fa845b882873af1f01305f8 +msgid "PDF only: Saves the document in its **current state**." +msgstr "" + +#: ../../document.rst:1137 3929e84a5b25413e9e9fcb2bcb36c19a +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 "" + +#: ../../document.rst:1139 706a9974da7d439bb3621ac91b00a7d1 +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:1139 b077b262cbf54db285b38e3f2513eb02 +msgid "Do garbage collection. Positive values exclude \"incremental\"." +msgstr "" + +#: ../../document.rst:1141 ../../document.rst:1159 +#: 92fb12675d1f4d91b06aa7afd71d94c0 e54e8dbf135842ff8868ab38d052236e +msgid "0 = none" +msgstr "" + +#: ../../document.rst:1142 328be35ac3054be09e40dc89dd40739b +msgid "1 = remove unused (unreferenced) objects." +msgstr "" + +#: ../../document.rst:1143 44f4e0ba160a41258103b8b362d183ba +msgid "2 = in addition to 1, compact the :data:`xref` table." +msgstr "" + +#: ../../document.rst:1144 4d7de456044c43e5bf84904b919e36f0 +msgid "3 = in addition to 2, merge duplicate objects." +msgstr "" + +#: ../../document.rst:1145 900fe2108c6c4e409e8b9e29ad93c35c +msgid "" +"4 = in addition to 3, check :data:`stream` objects for duplication. This " +"may be slow because such data are typically large." +msgstr "" + +#: ../../document.rst:1147 7426abe389064364a866ad0fa01dec9a +msgid "" +"Clean and sanitize content streams [#f1]_. Corresponds to \"mutool clean " +"-sc\"." +msgstr "" + +#: ../../document.rst:1149 f5111ac9d3dc43f69ab779b026119713 +msgid "Deflate (compress) uncompressed streams." +msgstr "" + +#: ../../document.rst:1150 3edd7108a3784e7ca5eaeae383e7720a +msgid "*(new in v1.18.3)* Deflate (compress) uncompressed image streams [#f4]_." +msgstr "" + +#: ../../document.rst:1151 288e82e3dd9d4de9ac13496840b28465 +msgid "" +"*(new in v1.18.3)* Deflate (compress) uncompressed fontfile streams " +"[#f4]_." +msgstr "" + +#: ../../document.rst:1153 5bc690908c714bc68aa3f0917272679e +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 "" + +#: ../../document.rst:1155 ef7553334e1145b194951da5d50e25dc +msgid "convert binary data to ASCII." +msgstr "" + +#: ../../document.rst:1157 9f7fe03c232b4340ab02598e4c33fa99 +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:1157 e54508def5ae46d3afcf728965d69fce +msgid "" +"Decompress objects. Generates versions that can be better read by some " +"other programs and will lead to larger files." +msgstr "" + +#: ../../document.rst:1160 a0db4e5078ff446ea93f928f0a2e8bb7 +msgid "1 = images" +msgstr "" + +#: ../../document.rst:1161 c04292c9f1914536b5f9b08f5e690596 +msgid "2 = fonts" +msgstr "" + +#: ../../document.rst:1162 e885821772994caea994d8ff4292c70b +msgid "255 = all" +msgstr "" + +#: ../../document.rst:1164 c01b3d6e69af42c2854650fbed2388cb +msgid "" +"Save a linearised version of the document. This option creates a file " +"format for improved performance for Internet access. Excludes " +"\"incremental\"." +msgstr "" + +#: ../../document.rst:1166 3e76be04a41244608aef73ae4ae2b67d +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 "" + +#: ../../document.rst:1168 f927eebd1adc491982a84f195056a8d4 +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 "" + +#: ../../document.rst:1170 f586ba17de9145d082794f34b2934218 +msgid "" +"*(new in v1.16.0)* Set the desired permission levels. See " +":ref:`PermissionCodes` for possible values. Default is granting all." +msgstr "" + +#: ../../document.rst:1172 d0ec00fa43334adcbb904a6f795a5831 +msgid "" +"*(new in v1.16.0)* set the desired encryption method. See " +":ref:`EncryptionMethods` for possible values." +msgstr "" + +#: ../../document.rst:1174 9c18c328f23341508ad777390d7ae718 +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 "" + +#: ../../document.rst:1176 a4e10670641c41878f3bd08b990da0ae +msgid "" +"*(new in v1.16.0)* set the document's user password. The string length " +"must not exceed 40 characters." +msgstr "" + +#: ../../document.rst:1178 038325e6a1724e4c9a04296fc85d7a8e +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:1182 2c22c3e8ad1649e287dd7f2e91d3b306 +msgid "New in v1.18.11" +msgstr "" + +#: ../../document.rst:1184 75f304867ac8419b8abfe57bcf660758 +msgid "" +"PDF only: The same as :meth:`Document.save` but with the changed defaults" +" `deflate=True, garbage=3`." +msgstr "" + +#: ../../document.rst:1188 0e909f69bb7c4783abdcf6d679c00022 +msgid "" +"PDF only: saves the document incrementally. This is a convenience " +"abbreviation for *doc.save(doc.name, incremental=True, " +"encryption=PDF_ENCRYPT_KEEP)*." +msgstr "" + +#: ../../document.rst:1192 15d098ce15104f6a9aac85b96182ff4d +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:1200 905f04894be94977b7f459e7cb355da9 +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 "" + +#: ../../document.rst:1202 499de08e1c4f40b0b5ad52758a315f16 +msgid "*(Changed in v1.16.0)* for extended encryption support." +msgstr "" + +#: ../../document.rst:1205 9592ce120efe426abf9dcd2cb2e1c27d +msgid "a bytes object containing the complete document." +msgstr "" + +#: ../../document.rst:1209 ff1ec35942af40449ce7d42c781045fd +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 "" + +#: ../../document.rst:1225 60ca13f06218470cb6317c2fba051bb4 +msgid "" +"Changed in v1.19.3 - as a fix to issue `#537 " +"`_, form fields are always" +" excluded." +msgstr "" + +#: ../../document.rst:1227 b3eaa0fc2f2043b58033867a09563de7 +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 and annotations can be " +"excluded in the target, see below. All page numbers are 0-based." +msgstr "" + +#: ../../document.rst:1229 3e2e25f5daf84e0a8f8e170c48c203ba +msgid "" +"An opened PDF *Document* which must not be the current document. However," +" it may refer to the same underlying file." +msgstr "" + +#: ../../document.rst:1232 4d620897b8a84265a492a9c341733e78 +msgid "First page number in *docsrc*. Default is zero." +msgstr "" + +#: ../../document.rst:1234 2608a987bce146e4b28e4628ec72bc57 +msgid "Last page number in *docsrc* to copy. Defaults to last page." +msgstr "" + +#: ../../document.rst:1236 8d3f22a9474e4a7ea3dfa099121b06b8 +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 "" + +#: ../../document.rst:1238 651177dbb9bc451ca7699aafdca955c2 +msgid "" +"All copied pages will be rotated by the provided value (degrees, integer " +"multiple of 90)." +msgstr "" + +#: ../../document.rst:1240 2a250f2ae69644f09eef783f15d05d37 +msgid "" +"Choose whether (internal and external) links should be included in the " +"copy. Default is *True*. Internal links to outside the copied page range " +"are **always excluded**." +msgstr "" + +#: ../../document.rst:1241 8568340fe9904e0ea30c862d88d6c6b2 +msgid "" +"*(new in v1.16.1)* choose whether annotations should be included in the " +"copy. *(Fixed in v1.19.3)* Form fields can never be copied." +msgstr "" + +#: ../../document.rst:1242 775bfbd613974e7fb194160fded741dc +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 "" + +#: ../../document.rst:1243 d718f2fd8f974661a2139013b09f0bcc +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 "" + +#: ../../document.rst:1247 1b29ec1c892a4db2884a7e07d60f73b9 +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 "" + +#: ../../document.rst:1249 d5346e99f53146b9880563657c17c708 +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 "" + +#: ../../document.rst:1266 515affcd6c824c179d0711af7fbd2806 +msgid "New in v1.22.0" +msgstr "" + +#: ../../document.rst:1268 cb01b037a5bd42cb9700d1e83edd1305 +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 "" + +#: ../../document.rst:1270 7dd00eb14bd846b99cba8093cd34459d +msgid "" +"the input document to insert. May be a filename specification as is valid" +" for creating a :ref:`Document` or a :ref:`Pixmap`." +msgstr "" + +#: ../../document.rst:1279 8097f1fb1f74430e8150d077b886340d +msgid "PDF only: Insert an empty page." +msgstr "" + +#: ../../document.rst:1281 09ddcf0b810848aea3442bce5702c16e +msgid "" +"page number in front of which the new page should be inserted. Must be in" +" *1 < pno <= page_count*. Special values -1 and *doc.page_count* insert " +"**after** the last page." +msgstr "" + +#: ../../document.rst:1283 71dc5751067946a8854301b476a0cfc7 +msgid "page width." +msgstr "" + +#: ../../document.rst:1284 b8bde47ae1204a3f8271939eaeb12602 +msgid "page height." +msgstr "" + +#: ../../document.rst:1287 5a7d34d771324321afdc7568eeb8ada8 +msgid "the created page object." +msgstr "" + +#: ../../document.rst:1299 05627a710c5f496f920fee6289a73734 +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 "" + +#: ../../document.rst:1301 85c500d98fc844dd91e94149d6a10d4a +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 "" + +#: ../../document.rst:1301 078584a18c6b4ce3aa9318d9f8f18f4b +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." +msgstr "" + +#: ../../document.rst:1304 c6c05e3160a144fe9ea94eb1e7d024ff +msgid "Changed in v1.14.12" +msgstr "" + +#: ../../document.rst:1304 f05326907fd146f3ad2c5e910da771ff +msgid "This is now a positional parameter" +msgstr "" + +#: ../../document.rst:1306 0b55a3884dcf42e0a2a9d214bb1f6dc8 +msgid "For the other parameters, please consult the aforementioned methods." +msgstr "" + +#: ../../document.rst:1309 b7c07014fcb445e29b6f18e2231ec3c1 +msgid "" +"the result of :meth:`Page.insert_text` (number of successfully inserted " +"lines)." +msgstr "" + +#: ../../document.rst:1313 252f21d36b9142dbb05fd2c3513a7de0 +msgid "" +"PDF only: Delete a page given by its 0-based number in `-∞ < pno < " +"page_count - 1`." +msgstr "" + +#: ../../document.rst:1315 ../../document.rst:1322 +#: 0185783c7d044a8b9ad507b7e77c39f1 c192bc824bcc4e2f9b5f0fb513ce445d +msgid "Changed in v1.18.14: support Python's `del` statement." +msgstr "" + +#: ../../document.rst:1317 d066faa44e614cbfa8bcf890b72b60b6 +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:1321 7f108cfae1d74fe990f2888839163111 +msgid "Changed in v1.18.13: more flexibility specifying pages to delete." +msgstr "" + +#: ../../document.rst:1324 bb5d1a2639a44beeb2f51a359d342ed0 +msgid "PDF only: Delete multiple pages given as 0-based numbers." +msgstr "" + +#: ../../document.rst:1328 078bd72495a64af3b81944e9a80ddb98 +msgid "" +"**Format 1:** Use keywords. Represents the old format. A contiguous range" +" of pages is removed." +msgstr "" + +#: ../../document.rst:1327 e794e304e8fd49789a1a85bc5c4a00ca +msgid "\"from_page\": first page to delete. Zero if omitted." +msgstr "" + +#: ../../document.rst:1328 be3ef05aa2ab4fc183966c29be398696 +msgid "" +"\"to_page\": last page to delete. Last page in document if omitted. Must " +"not be less then \"from_page\"." +msgstr "" + +#: ../../document.rst:1330 49944ed7a2af419e9dc19ab15c924f42 +msgid "" +"**Format 2:** Two page numbers as positional parameters. Handled like " +"Format 1." +msgstr "" + +#: ../../document.rst:1332 83fcc4ab7c114e499b4259391e74881b +msgid "" +"**Format 3:** One positional integer parameter. Equivalent to " +":meth:`Page.delete_page`." +msgstr "" + +#: ../../document.rst:1334 9599817b113741d0b2114693024d6b8b +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 "" + +#: ../../document.rst:1336 ec31c21b86824b858feebe10ebe29798 +msgid "" +"**Format 5:** *(New in v1.18.14)* Using the Python `del` statement and " +"index / slice notation is now possible." +msgstr "" + +#: ../../document.rst:1340 280c28074ed84bf8867021747d4f8b07 +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 "" + +#: ../../document.rst:1342 9b47a29279094a77a589d55ae678a7fd +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:1344 6057633e8fbc41f3846fc6e101034234 +msgid "Following examples will all delete pages 500 through 519:" +msgstr "" + +#: ../../document.rst:1346 13e06c20769b409896fcf343c3e5bb03 +msgid "`doc.delete_pages(500, 519)`" +msgstr "" + +#: ../../document.rst:1347 d5f1a7aa1c2441eeabd9c39ff5d64040 +msgid "`doc.delete_pages(from_page=500, to_page=519)`" +msgstr "" + +#: ../../document.rst:1348 266d33c6b95f48e8a1c6073c98a13c19 +msgid "`doc.delete_pages((500, 501, 502, ... , 519))`" +msgstr "" + +#: ../../document.rst:1349 fcb1183fd4fc440b8bc5bcf9b94768f8 +msgid "`doc.delete_pages(range(500, 520))`" +msgstr "" + +#: ../../document.rst:1350 dc188109404443738c29ab665d2bf0f7 +msgid "`del doc[500:520]`" +msgstr "" + +#: ../../document.rst:1351 147182ac126045a8869c4dd33ee68c3d +msgid "`del doc[(500, 501, 502, ... , 519)]`" +msgstr "" + +#: ../../document.rst:1352 f3a569e45dd14d8dac7c5d5ca9de31e2 +msgid "`del doc[range(500, 520)]`" +msgstr "" + +#: ../../document.rst:1354 50e383f68b8744a49e996d9f9208596b +msgid "" +"For the :ref:`AdobeManual` the above takes about 0.6 seconds, because the" +" remaining 1290 pages must be cleaned from invalid links." +msgstr "" + +#: ../../document.rst:1356 cc6681c7970d4fa9a13cf4f80d612f04 +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 "" + +#: ../../document.rst:1361 37e24c8adf444f63b62e2ae5f336cd05 +msgid "PDF only: Copy a page reference within the document." +msgstr "" + +#: ../../document.rst:1363 09202da23d8740848128e01c9c856590 +msgid "the page to be copied. Must be in range `0 <= pno < page_count`." +msgstr "" + +#: ../../document.rst:1365 ../../document.rst:1377 +#: 230e24dc1f5749f5971273058801e7b7 39a1136b88d24c96adad7d1573707e90 +msgid "" +"the page number in front of which to copy. The default inserts **after** " +"the last page." +msgstr "" + +#: ../../document.rst:1367 b05f0a41a1844f40946316ecdbf39a7a +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 "" + +#: ../../document.rst:1371 a1a5d303a1f844cdbac6555f6928fb78 +msgid "New in v1.14.17" +msgstr "" + +#: ../../document.rst:1373 7d43c885b032422aaa3873b99ea0b044 +msgid "PDF only: Make a full copy (duplicate) of a page." +msgstr "" + +#: ../../document.rst:1375 3a9dc6a7b81644c1bca7a7def02c3894 +msgid "the page to be duplicated. Must be in range `0 <= pno < page_count`." +msgstr "" + +#: ../../document.rst:1381 8d295a3602c647fda38413fb69a7bb1c +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 "" + +#: ../../document.rst:1383 83f5662399944b28ad85875fa6517f4f +msgid "" +"Any Popup and \"IRT\" (\"in response to\") annotations are **not copied**" +" to avoid potentially incorrect situations." +msgstr "" + +#: ../../document.rst:1387 5232730dcf9c4f989707e1f397fd2dc5 +msgid "PDF only: Move (copy and then delete original) a page within the document." +msgstr "" + +#: ../../document.rst:1389 fd607108147b43b5a3ae58da57b60c8c +msgid "the page to be moved. Must be in range `0 <= pno < page_count`." +msgstr "" + +#: ../../document.rst:1391 df9c0d350a33453788ff98fdfbde3b91 +msgid "" +"the page number in front of which to insert the moved page. The default " +"moves **after** the last page." +msgstr "" + +#: ../../document.rst:1396 8778b8c0c5f344f8a7a46c85d6271fe9 +msgid "New in v1.17.4" +msgstr "" + +#: ../../document.rst:1398 b641360398dd478581ab3a524a9503f2 +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 "" + +#: ../../document.rst:1400 619161b6a86d49a5b21a797509949716 +msgid "" +"set the property to this value. If omitted or `None`, inquire the current" +" value." +msgstr "" + +#: ../../document.rst:1403 a55ed9b566b24c17a01bb138ae9811f4 +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:1404 8fc8b0ccb5b8427a9a0051f15baa7156 +msgid "None: not a Form PDF, or property not defined." +msgstr "" + +#: ../../document.rst:1405 2a49677423f6460cbdd36304ce0d39c8 +msgid "" +"True / False: the value of the property (either just set or existing for " +"inquiries). Has no effect if no Form PDF." +msgstr "" + +#: ../../document.rst:1411 cae9d4bec1f94f02874d85cca797f378 +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 "" + +#: ../../document.rst:1414 0f9ea0b9904d41c5992743b623578fda +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:1415 d2986ee946a2400f81e47ee0aea07594 +msgid "-1: not a Form PDF / no signature fields recorded / no *SigFlags* found." +msgstr "" + +#: ../../document.rst:1416 8e32d0dadf574cb3a8f87cbc942ab78a +msgid "1: at least one signature field exists." +msgstr "" + +#: ../../document.rst:1417 c5cb35588d6b415e92816008c0dbec36 +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 "" + +#: ../../document.rst:1426 32e45ae8e6f1461b97f495d33fa2a0ff +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 "" + +#: ../../document.rst:1428 a47cf8af547a47c889e662d3b4442195 +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 "" + +#: ../../document.rst:1430 9e2b3fd7ee0e405895a3bbd824df025e +msgid "entry identifier, **must not already exist**." +msgstr "" + +#: ../../document.rst:1431 777acb578cff473f81038f385bec432c +msgid "" +"file contents. *(Changed in v1.14.13)* *io.BytesIO* is now also " +"supported." +msgstr "" + +#: ../../document.rst:1431 cf495aedc0ff44a595e3745ec98d0e8a +msgid "file contents." +msgstr "" + +#: ../../document.rst:1433 ../../document.rst:1509 +#: 255b389de6dd4922846152fbd8364216 8caf7f8bf24f4f4ea09c0dfdf3689907 +msgid "*(Changed in v1.14.13)* *io.BytesIO* is now also supported." +msgstr "" + +#: ../../document.rst:1435 c216e5017df34c4ca3a566eff7a9505f +msgid "optional filename. Documentation only, will be set to *name* if `None`." +msgstr "" + +#: ../../document.rst:1436 8ab90748c60841de8d57a05d8ae55f97 +msgid "" +"optional unicode filename. Documentation only, will be set to *filename* " +"if `None`." +msgstr "" + +#: ../../document.rst:1437 dfebebef30f44f729b829f0d24ddf253 +msgid "optional description. Documentation only, will be set to *name* if `None`." +msgstr "" + +#: ../../document.rst:1440 685ab2df5b61445eb93ab1767d2df7bd +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 "" + +#: ../../document.rst:1445 3d9f381d6aba46bd8654d0215f316044 +msgid "" +"Changed in v1.14.16: This is now a method. In previous versions, this was" +" a property." +msgstr "" + +#: ../../document.rst:1447 15a406ff631344deba2dd7253e8611e3 +msgid "PDF only: Return the number of embedded files." +msgstr "" + +#: ../../document.rst:1451 5377e898d1c644ab918259487bd78c79 +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 "" + +#: ../../document.rst:1453 ../../document.rst:1473 ../../document.rst:1506 +#: 55d39330954b4d27af2ffe005f7561b1 69ebc824b40542a095ee5d5c9c7e26f4 +#: ecedda5d2a644de481e3d64d5aafd0f3 +msgid "index or name of entry. An integer must be in `range(embfile_count())`." +msgstr "" + +#: ../../document.rst:1459 cd5a885bbb37448394cd01700603cd79 +msgid "Changed in v1.14.16: Items can now be deleted by index, too." +msgstr "" + +#: ../../document.rst:1461 f8091c95a026444c8ad325aee5ebfcec +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 "" + +#: ../../document.rst:1463 6f3d4f764d604ec3946794f5211720eb +msgid "index or name of entry." +msgstr "" + +#: ../../document.rst:1465 eddff131329342d2b0c13db420a8e35a +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 "" + +#: ../../document.rst:1469 bd212f024e0d4a66b74b729af5ea35f2 +msgid "Changed in v1.18.13" +msgstr "" + +#: ../../document.rst:1471 165e75d5293f423382253d35e7f6fd49 +msgid "" +"PDF only: Retrieve information of an embedded file given by its number or" +" by its name." +msgstr "" + +#: ../../document.rst:1476 709ad8f74c9643d5ba1b0ccb911326c2 +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 "" + +#: ../../document.rst:1476 9d4a08fd544e48b6b490740e9997e1ea +msgid "a dictionary with the following keys:" +msgstr "" + +#: ../../document.rst:1478 d054b8daf4254dff966b3c01f52affb1 +msgid "*name* -- (*str*) name under which this entry is stored" +msgstr "" + +#: ../../document.rst:1479 6bc9672cd6fc4dd8abf2eba23e0acc9b +msgid "*filename* -- (*str*) filename" +msgstr "" + +#: ../../document.rst:1480 1526ffefdc4b46b5bdfeb449e2c5ee1f +msgid "*ufilename* -- (*unicode*) filename" +msgstr "" + +#: ../../document.rst:1481 f3355e4e7e9a4cbbae9ed372f49a85f0 +msgid "*desc* -- (*str*) description" +msgstr "" + +#: ../../document.rst:1482 191b51803f58421bb76521ad969bc161 +msgid "*size* -- (*int*) original file size" +msgstr "" + +#: ../../document.rst:1483 3a9ac748411045c297c539596550214d +msgid "*length* -- (*int*) compressed file length" +msgstr "" + +#: ../../document.rst:1484 d54b54fa29cc480c83e1d129fec93d0b +msgid "" +"*creationDate* -- *(New in v1.18.13)* (*str*) date-time of item creation " +"in PDF format" +msgstr "" + +#: ../../document.rst:1485 be5721ff8a164421a69984a31e6c576d +msgid "" +"*modDate* -- *(New in v1.18.13)* (*str*) date-time of last change in PDF " +"format" +msgstr "" + +#: ../../document.rst:1486 61422d6c332b4d758eb96563fed94780 +msgid "" +"*collection* -- *(New in v1.18.13)* (*int*) :data:`xref` of the " +"associated PDF portfolio item if any, else zero." +msgstr "" + +#: ../../document.rst:1487 2fed05de7ba44cd79705d8ddff14d23d +msgid "" +"*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 "" + +#: ../../document.rst:1491 a34c50c116d14d37816fd8717e6ffd44 +msgid "New in v1.14.16" +msgstr "" + +#: ../../document.rst:1493 90b796a9e76340c09bf8dbe97c03aa3b +msgid "" +"PDF only: Return a list of embedded file names. The sequence of the names" +" equals the physical sequence in the document." +msgstr "" + +#: ../../document.rst:1504 4f96a700a250469b8cee322718f9e326 +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 "" + +#: ../../document.rst:1507 f969298524ef4b58be8981b6f68861d4 +msgid "" +"the new file content. *(Changed in v1.14.13)* *io.BytesIO* is now also " +"supported." +msgstr "" + +#: ../../document.rst:1507 8d53cd89781f440b98e7eaa6e875eff7 +msgid "the new file content." +msgstr "" + +#: ../../document.rst:1511 525e3fd5cef54c21ae7a532d7a86f198 +msgid "the new filename." +msgstr "" + +#: ../../document.rst:1512 44dbc92577034b108719663f549ee255 +msgid "the new unicode filename." +msgstr "" + +#: ../../document.rst:1513 f8ea4859aa1c4d329a0b036e8cb62eb4 +msgid "the new description." +msgstr "" + +#: ../../document.rst:1515 3e741f91ad14474ea2a90a8ce7c81091 +msgid "" +"*(Changed in v1.18.13)* The method now returns the :data:`xref` of the " +"file object." +msgstr "" + +#: ../../document.rst:1518 67a5c368dae547beafeaabf9e96f47cc +msgid "" +"xref of the file object. Automatically, its `/ModDate` PDF key will be " +"updated with the current date-time." +msgstr "" + +#: ../../document.rst:1523 12c02df4e9ba4399a92209d80dcec4b1 +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 "" + +#: ../../document.rst:1527 ../../document.rst:1541 ../../document.rst:1548 +#: ../../document.rst:1555 ../../document.rst:1566 ../../document.rst:1575 +#: ../../document.rst:1724 0100e39e914e400b89977de20701928c +#: 0675440791a044fb95edb1ad23521a43 3dd52da84b814e9bb0990104b7193c0f +#: 82dcc882b06044a1991c074a4fb947cf c860bee8c22141e0bdf0ffda3b292f7c +#: e12000ea0e924c7482053930e4bc9b75 e9e82bc284f848c782bc0a0ffd6bdcc3 +msgid "New in v1.16.8" +msgstr "" + +#: ../../document.rst:1528 7f7b3cfa75034b08a13a8cb22a256fe3 +msgid "Changed in v1.18.10" +msgstr "" + +#: ../../document.rst:1530 94d022be275443b68f7950acc14afb33 +msgid "PDF only: Return the definition source of a PDF object." +msgstr "" + +#: ../../document.rst:1532 f5998defbe6e4c1dbf17b2f8297af575 +msgid "" +"the object's :data`xref`. *Changed in v1.18.10:* A value of -1 returns " +"the PDF trailer source." +msgstr "" + +#: ../../document.rst:1533 3f03267b3781486ebfbb186745a94170 +msgid "whether to generate a compact output with no line breaks or spaces." +msgstr "" + +#: ../../document.rst:1534 0d03e6b3054c49308f0e4d8337814fc2 +msgid "whether to ASCII-encode binary data." +msgstr "" + +#: ../../document.rst:1537 8da7de1514f844cbabbe15217c967364 +msgid "The object definition source." +msgstr "" + +#: ../../document.rst:1543 4b799bacfe3540ceba2f9a46bd04c87f +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 "" + +#: ../../document.rst:1550 6fade210ddaa4db69168743d33dd7c41 +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 " +"*xref* argument of -1." +msgstr "" + +#: ../../document.rst:1557 f07b57753b9a4e59a9e6214b53532c2c +msgid "" +"PDF only: Return the **decompressed** contents of the :data:`xref` stream" +" object." +msgstr "" + +#: ../../document.rst:1559 ../../document.rst:1579 ../../document.rst:1598 +#: 324a4865736e4edd8ac5251f9c24f761 6e6bdc623a074237ba8ba4a7cc335e0f +#: ae16c0bd23644cd6894ef0cc5c34c54a +msgid ":data:`xref` number." +msgstr "" + +#: ../../document.rst:1562 f5704c848be348f2b86f250d1f53f7d5 +msgid "the (decompressed) stream of the object." +msgstr "" + +#: ../../document.rst:1568 568b48afbfae4fd7bb796d3890754a0a +msgid "" +"PDF only: Return the **unmodified** (esp. **not decompressed**) contents " +"of the :data:`xref` stream object. Otherwise equal to " +":meth:`Document.xref_stream`." +msgstr "" + +#: ../../document.rst:1571 33d6b0d845de4284a89ebcf8bab38b74 +msgid "the (original, unmodified) stream of the object." +msgstr "" + +#: ../../document.rst:1577 b5970deacb98421db7603d8f8127facc +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 "" + +#: ../../document.rst:1581 b1e9225e7adf4100bc91204076e60e81 +msgid "a string containing a valid PDF object definition." +msgstr "" + +#: ../../document.rst:1583 e90ff7e1b6b24b0bb0ac902e258ddebf +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:1587 0eeb1fbd8090470aa27133a7cf837b9e +msgid "zero if successful, otherwise an exception will be raised." +msgstr "" + +#: ../../document.rst:1592 9f3502bb8d4c40d6910983d631e6db9d +msgid "New in v.1.16.8" +msgstr "" + +#: ../../document.rst:1593 0bfb526a56c9462585f03af76cda1e62 +msgid "Changed in v1.19.2: added parameter \"compress\"" +msgstr "" + +#: ../../document.rst:1594 0ebc6e56fb9c4624afc0ce520d97684b +msgid "" +"Changed in v1.19.6: deprecated parameter \"new\". Now confirms that the " +"object is a PDF dictionary object." +msgstr "" + +#: ../../document.rst:1596 3a8f52b855ef44ccb9548bfb8772d9c6 +msgid "" +"Replace the stream of an object identified by *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 "" + +#: ../../document.rst:1600 291b4adcc71440af95bcdae757b14143 +msgid "" +"the new content of the stream. *(Changed in v1.14.13:)* *io.BytesIO* " +"objects are now also supported." +msgstr "" + +#: ../../document.rst:1600 74f5a898fbad4c8697c45f99fe509ad2 +msgid "the new content of the stream." +msgstr "" + +#: ../../document.rst:1602 e96d3e88c52e42969b63fcacc04932df +msgid "*(Changed in v1.14.13:)* *io.BytesIO* objects are now also supported." +msgstr "" + +#: ../../document.rst:1604 90dc46fc917548fc819327dd55b7239c +msgid "*deprecated* and ignored. Will be removed some time after v1.20.0." +msgstr "" + +#: ../../document.rst:1605 26506aa3dd484b0bbfde40ceb85cfd6b +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 "" + +#: ../../document.rst:1607 dd76cb6474ae4373b3ab7a98897c34a5 +msgid "" +"if *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 "" + +#: ../../document.rst:1609 3254ee8ec6794c58884c26b7614ff39e +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 "" + +#: ../../document.rst:1611 0085186ae2dd4f5da54704938de3cf52 +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 "" + +#: ../../document.rst:1613 723a48f95ba84e76adc974106031a46e +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 "" + +#: ../../document.rst:1618 13500ba88e564a66bfc44eaa9ee45aee +msgid "New in v1.19.5" +msgstr "" + +#: ../../document.rst:1620 cc244182db2b4805b19dcf47d5f9dd0f +msgid "" +"PDF Only: Make *target* xref an exact copy of *source*. If *source* is a " +":data:`stream`, then these data are also copied." +msgstr "" + +#: ../../document.rst:1622 317b34a84ed344a58bd865b88f4be098 +msgid "the source :data:`xref`. It must be an existing **dictionary** object." +msgstr "" + +#: ../../document.rst:1623 dcb599871a4d40c29a27d6365dcfbb0b +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 "" + +#: ../../document.rst:1624 935caeb4f7d6423ba1d460928c93f674 +msgid "" +"an optional list of top-level keys in *target*, that should not be " +"removed in preparation of the copy process." +msgstr "" + +#: ../../document.rst:1628 cddf45eccd6e4ded8a905e137cee0637 +msgid "This method has much in common with Python's *dict* method `copy()`." +msgstr "" + +#: ../../document.rst:1629 946257c60b8c408f9b7b3bdddc7eb5a2 +msgid "Both xref numbers must represent existing dictionaries." +msgstr "" + +#: ../../document.rst:1630 0b1c524d392b476eb3fa1a16db575734 +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 "" + +#: ../../document.rst:1631 22493e2bb677440f9c1e7f105fd7741c +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 "" + +#: ../../document.rst:1632 e513e7a7feb943aabd798778f507243c +msgid "" +"A typical use case is to replace or remove an existing image without " +"using redaction annotations. Example scripts can be seen `here " +"`_." +msgstr "" + +#: ../../document.rst:1636 868e2b0a2df64a33aeae1bf96ef972ba +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 "" + +#: ../../document.rst:1638 4daba6522085437b861e860370c859e8 +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 "" + +#: ../../document.rst:1641 f025441c9b5744b9b589901ee3b63af3 +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:1641 3d26306a275a4b28895be536ce930495 +msgid "a dictionary with the following keys" +msgstr "" + +#: ../../document.rst:1643 40609371191740d4824c53138c46a2f6 +msgid "*ext* (*str*) image type (e.g. *'jpeg'*), usable as image file extension" +msgstr "" + +#: ../../document.rst:1644 90df04cb2f7148269b9fa14d1171a19c +msgid "*smask* (*int*) :data:`xref` number of a stencil (/SMask) image or zero" +msgstr "" + +#: ../../document.rst:1645 029717138a0c4ddaa7e2bf280817d4ba +msgid "*width* (*int*) image width" +msgstr "" + +#: ../../document.rst:1646 4fd1adfbbc0147028f6307042345b21f +msgid "*height* (*int*) image height" +msgstr "" + +#: ../../document.rst:1647 d9bde39256f54667b31281dd738126e2 +msgid "*colorspace* (*int*) the image's *colorspace.n* number." +msgstr "" + +#: ../../document.rst:1648 08afe2e53ccd43aebfe8caf422dc1d31 +msgid "*cs-name* (*str*) the image's *colorspace.name*." +msgstr "" + +#: ../../document.rst:1649 c444bdaf647e49efa9f9bebbb843f2b7 +msgid "" +"*xres* (*int*) resolution in x direction. Please also see " +":data:`resolution`." +msgstr "" + +#: ../../document.rst:1650 2a78e644b9ca47d68bbdd756e59f89b5 +msgid "" +"*yres* (*int*) resolution in y direction. Please also see " +":data:`resolution`." +msgstr "" + +#: ../../document.rst:1651 e50644e40cdb4991b631502e0b2b5a44 +msgid "*image* (*bytes*) image data, usable as image file content" +msgstr "" + +#: ../../document.rst:1663 4b97f33b15a643eda104551fd07e88bc +msgid "" +"There is a functional overlap with *pix = fitz.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 "" + +#: ../../document.rst:1665 d17ec3782a864512a80c25396431bfbc +msgid "xref 1268 is a PNG -- Comparable execution time and identical output::" +msgstr "" + +#: ../../document.rst:1677 32fbb8d2af0746fe9331e9532931226f +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 "" + +#: ../../document.rst:1692 ac85178a9f5845c68b1cc7d006a09dba +msgid "Changed in v1.19.4: return a dictionary if `named == True`." +msgstr "" + +#: ../../document.rst:1694 4b84aae9c4564c4f967297f49249ae33 +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 "" + +#: ../../document.rst be7456cd325d426bbd9189f9d2f315fb +msgid "arg int xref" +msgstr "" + +#: ../../document.rst:1696 9bf05e77a0ae432f9000934d454d377d +msgid "PDF object number of the font to extract." +msgstr "" + +#: ../../document.rst 80647003088f497781ee1e68ccbbedb2 +msgid "arg bool info_only" +msgstr "" + +#: ../../document.rst:1697 f11e99b4d1f546c99d8bc985d126637a +msgid "" +"only return font information, not the buffer. To be used for information-" +"only purposes, avoids allocation of large buffer areas." +msgstr "" + +#: ../../document.rst 846ae3b729f4442a959535a41a4156f4 +msgid "arg bool named" +msgstr "" + +#: ../../document.rst:1698 5009631e50ea4257b3f0807b9bb87f24 +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 "" + +#: ../../document.rst 46b8e241f3334f819195647f2108be8a +msgid "rtype" +msgstr "" + +#: ../../document.rst:1700 b36cf6b0ca85407ea297ec0a8e49c750 +msgid "tuple,dict" +msgstr "" + +#: ../../document.rst 4ed5126141cb4583961eaa2f0544408b +msgid "returns" +msgstr "" + +#: ../../document.rst:1701 d4b8d30d6d464e1ba23de538181d1b26 +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 "" + +#: ../../document.rst:1703 af1335d515984608ab279779224de8b5 +msgid "" +"`(\"\", \"\", \"\", b\"\")` -- invalid xref or xref is not a (valid) font" +" object." +msgstr "" + +#: ../../document.rst:1704 004295092a2e419583791b9e472de2c8 +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 "" + +#: ../../document.rst:1706 bb6d8132c34e45ef8f2e8ef0d147351c +msgid "Example:" +msgstr "" + +#: ../../document.rst:1715 8222abf77c0d4cd393cf087aa865408a +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 "" + +#: ../../document.rst:1718 4a91ceb493884498873aa6fe73ff9042 +msgid "" +"The returned *basename* in general is **not** the original file name, but" +" it probably has some similarity." +msgstr "" + +#: ../../document.rst:1719 a13d8f6625b64d818f04c41afa02d30f +msgid "" +"If parameter `named == True`, a dictionary with the following keys is " +"returned: `{'name': 'T1', 'ext': 'n/a', 'type': 'Type3', 'content': " +"b''}`." +msgstr "" + +#: ../../document.rst:1726 f101d8a1e731416db25d0966580e8b05 +msgid "PDF only: Return the :data:`xref` of the document's XML metadata." +msgstr "" + +#: ../../document.rst:1735 08910f07f5684300ad1d537ee4b7047f +msgid "" +"PDF only: Check whether there are links, resp. annotations anywhere in " +"the document." +msgstr "" + +#: ../../document.rst:1737 6319043308d640bb8d813fa311947bc5 +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 "" + +#: ../../document.rst:1742 bde6816c94e34dd1847978708cd0203b +msgid "New in v1.18.7, changed in v1.18.9" +msgstr "" + +#: ../../document.rst:1744 642fda7988c64e5ea0e9dfdcea548c2d +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 character subset." +msgstr "" + +#: ../../document.rst:1746 70bcc9642de84eb89371a914d69eed8a +msgid "" +"Use this method immediately before saving the document. The following " +"features and restrictions apply for the time being:" +msgstr "" + +#: ../../document.rst:1748 5fccbe1d5f484cd182ac448f287dd69f +msgid "" +"Package `fontTools `_ **must be " +"installed**. It is required for creating the font subsets. If not " +"installed, the method raises an `ImportError` exception." +msgstr "" + +#: ../../document.rst:1749 a7bfe6857e5c48eb8a0a813e75022eb0 +msgid "" +"Supported font types only include embedded OTF, TTF and WOFF that are " +"**not already subsets**." +msgstr "" + +#: ../../document.rst:1750 9d783067dd1541db9df711f12a6a9136 +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 "" + +#: ../../document.rst:1752 ebe0ba07b85041bc91eb608286cfde7a +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 "" + +#: ../../document.rst:1757 ../../document.rst:1763 ../../document.rst:1770 +#: ../../document.rst:1777 ../../document.rst:1786 ../../document.rst:1793 +#: ../../document.rst:1802 ../../document.rst:1809 ../../document.rst:1816 +#: ../../document.rst:1825 ../../document.rst:1834 +#: 3647fe15bee64a9183af931bf50f0f21 534846fcf2d742589036032dca1b6fb7 +#: 70ee8871e2c3416f89ce4529306191a6 845bca3abc324e978934e159501b2f01 +#: 8c2dc5b1055f4fb5b76c047f50259e8d a127bf22c2e54753b4b6fa4a9d3318da +#: be53991d5ffa413eb765ba0ea446a658 d9a8439706d9431993208937d500d787 +#: da66b84462eb484cbb7036e4e453ceab e1d34da048224c4e871ad24965c56c04 +#: f0beb299e5d64bea8e6487920937f7eb +msgid "New in v1.19.0" +msgstr "" + +#: ../../document.rst:1759 97215ada1163464797915a618af520bb +msgid "" +"PDF only: Enable journalling. Use this before you start logging " +"operations." +msgstr "" + +#: ../../document.rst:1765 7452edd8a00b424482a4f524c7ffdd06 +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 "" + +#: ../../document.rst:1772 7b983085a7de4f2eba5aa86f4a32539d +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 "" + +#: ../../document.rst:1779 d851122e06f9493fb68744c09aa3cf74 +msgid "" +"PDF only: Return the numbers of the current operation and the total " +"operation count." +msgstr "" + +#: ../../document.rst:1781 c084c3ae1e1a4dd69967c6b5bdcccafd +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 "" + +#: ../../document.rst:1788 b7b3af3ee5b54a96a8a4ba274cdd76c6 +msgid "PDF only: Return the name of operation number *step.*" +msgstr "" + +#: ../../document.rst:1795 7a28f0b4a88e4331aa72ceb151954348 +msgid "" +"PDF only: Show whether forward (\"redo\") and / or backward (\"undo\") " +"executions are possible from the current journal position." +msgstr "" + +#: ../../document.rst:1797 5685cb9fd05848c391233925a47a7135 +msgid "" +"a dictionary `{\"undo\": bool, \"redo\": bool}`. The respective method is" +" available if its value is `True`." +msgstr "" + +#: ../../document.rst:1804 f2f1eb491de14e59bcf43c7ee8006886 +msgid "" +"PDF only: Revert (undo) the current step in the journal. This moves " +"towards the journal's top." +msgstr "" + +#: ../../document.rst:1811 e402f064ee5b4e69880b33e82b2ebc97 +msgid "" +"PDF only: Re-apply (redo) the current step in the journal. This moves " +"towards the journal's bottom." +msgstr "" + +#: ../../document.rst:1818 7b10bb8c97384f87a40a79c0445098b6 +msgid "PDF only: Save the journal to a file." +msgstr "" + +#: ../../document.rst:1820 642137deaf1d46bdbf0ec1637ddce134 +msgid "" +"either a filename as string or a file object opened as \"wb\" (or an " +"`io.BytesIO()` object)." +msgstr "" + +#: ../../document.rst:1827 85c7e62dc2ef4c758a9c7243228a313e +msgid "" +"PDF only: Load journal from a file. Enables journalling for the document." +" If journalling is already enabled, an exception is raised." +msgstr "" + +#: ../../document.rst:1829 bc9c2369e3cc43038444147fc44960f9 +msgid "" +"the filename (str) of the journal or a file object opened as \"rb\" (or " +"an `io.BytesIO()` object)." +msgstr "" + +#: ../../document.rst:1836 72453436fc23435dbbc57440041cabe1 +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 "" + +#: ../../document.rst:1838 63f2095379034da7b882cd61a10e6dfd +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 "" + +#: ../../document.rst:1843 7e9cdf9bfc70405294e6b733a0c70f1f +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 "" + +#: ../../document.rst 06fee07c19df4ca4866fda0506504a7d +#: 07554c08db854b2a935063a7a87cf4df 179032e28ba04644b90ec10bb5e556d4 +#: 27f3285869294e2daafad0c7b62760aa 31c12d86bf784cad99fd7dafaac1d200 +#: 380d044de747491a9ffd15ecd2929ba9 3c2235f3abb149508c15c73f73d90211 +#: 437358658dcd4975bb1e5e7b0b521792 4cff98d714a0409496213634e2642531 +#: 4f1328ac7c2b46f1ad3e10278ac19dd7 509d0537ba494b8b9eff091acc9eed52 +#: 57cf5c6d4f334366a55ab1d08595df80 6a6f10a882e2403282c371e84a0e2dd3 +#: 6f2a7d9f005d4a36ae751727fd17d388 6fcd38e167b54169bd9593a15ae2004c +#: acdaacee54bc4b2387317a0b461f5839 ad8a461cc9fe4924bd7400876d82fdd0 +#: bee505c03cdb4104962f0d2e50f978cc c4cd6fa137b7418a8e1d124e5365a156 +#: ce05c411fe9b4c6b88b24925fc61e3c3 f4254b0f712c41a78147e19bbafef2c9 +msgid "type" +msgstr "" + +#: ../../document.rst:1845 cd26b25698a84e1ea235b8136213a38e +msgid ":ref:`Outline`" +msgstr "" + +#: ../../document.rst:1849 f3d6c362a8be4729ba8ef7cd2d511822 +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 "" + +#: ../../document.rst:1851 ../../document.rst:1857 ../../document.rst:1863 +#: ../../document.rst:1877 ../../document.rst:1885 ../../document.rst:1893 +#: ../../document.rst:1931 ../../document.rst:1937 +#: 38c31b4acc7b4a5dac11e984ec9c6bb5 6c8aeec3d4b34fe69f716d4e9c079b5f +#: 737610d72f7e488d805f772fe65a489a 81ceb43ff96f4cfa93f42166d2de6ced +#: a128a6d8bb18446590ce83f62e8d0544 d332175c533d4f18b13c6af19a077064 +#: d884c507b92d48e9a7626843d6110617 dd8cb55d1a434e1e9847a83615b662ea +msgid "bool" +msgstr "" + +#: ../../document.rst:1855 c25633438512490182882d10fc1a93ad +msgid "" +"*True* if this is a PDF document and contains unsaved changes, else " +"*False*." +msgstr "" + +#: ../../document.rst:1861 71d6ad16750b4ae382a966bb2c26b83d +msgid "*True* if this is a PDF document, else *False*." +msgstr "" + +#: ../../document.rst:1867 ea21649a05014700ae324fcafb461e73 +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 "" + +#: ../../document.rst:1869 134f8c24800a4d66b1fc17cb7c7a7f53 +msgid "*(Changed in v1.16.4)* Returns the total number of (root) form fields." +msgstr "" + +#: ../../document.rst:1871 306b2bda142445d78095bf63f4febdd9 +msgid "bool,int" +msgstr "" + +#: ../../document.rst:1875 acdb7958adb546fd8a3e139639a3b904 +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 "" + +#: ../../document.rst:1881 883048363c4842c7bd2da4c36f49adfe +msgid "New in v1.18.2" +msgstr "" + +#: ../../document.rst:1883 91cb1cac30d447238ef699c11a10285f +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 "" + +#: ../../document.rst:1891 a865784a5e1c453e9af8ff460fe26ceb +msgid "*True* if PDF is in linearized format. *False* for non-PDF documents." +msgstr "" + +#: ../../document.rst:1899 8b34ed52e262409880b140af1201931a +msgid "" +"A dictionary indicating the `/MarkInfo` value. If not specified, the " +"empty dictionary is returned. If not a PDF, `None` is returned." +msgstr "" + +#: ../../document.rst:1901 ../../document.rst:1965 +#: 06b555b25f624c2c9e3519b50953e6c5 31d5dd408493437c9f02081f4d4904e4 +msgid "dict" +msgstr "" + +#: ../../document.rst:1907 94c234d9f08e4b74aba22ce2c71ba588 +msgid "" +"A string containing the `/PageMode` value. If not specified, the default " +"\"UseNone\" is returned. If not a PDF, `None` is returned." +msgstr "" + +#: ../../document.rst:1909 ../../document.rst:1917 ../../document.rst:1971 +#: 0cf6a2fca6a54f1aba337009f4616f9f 8b2400e66c464bf1b86f644965a3c78b +#: d176710abe7b4f5886b9d32a9aca86b9 +msgid "str" +msgstr "" + +#: ../../document.rst:1915 fb779a4235cb47f995e12a24d859a851 +msgid "" +"A string containing the `/PageLayout` value. If not specified, the " +"default \"SinglePage\" is returned. If not a PDF, `None` is returned." +msgstr "" + +#: ../../document.rst:1923 e1c9af49b5ff41d5a9aef6915faca650 +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 "" + +#: ../../document.rst:1925 ../../document.rst:1945 ../../document.rst:1977 +#: ../../document.rst:1985 ../../document.rst:1993 +#: 059bb42aff9941f8aa2d7604306f4c48 1b8136aff2af478a99ff71a336e1218b +#: 1d5cbd9a8cfa479c85bf852e746e70af 48426b15277c47f39b9fbb5fca990887 +#: d88f295905944cf287d5fc11a8a03094 +msgid "int" +msgstr "" + +#: ../../document.rst:1929 f73cba6c721441f0b2ea3b47b35eb7dd +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 "" + +#: ../../document.rst:1935 514c17d4bc08425795f019ed86bb142c +msgid "" +"This indicator initially equals :attr:`Document.needs_pass`. After " +"successful authentication, it is set to *False* to reflect the situation." +msgstr "" + +#: ../../document.rst:1941 b657a8faac1143759932e69011b90a87 +msgid "" +"Changed in v1.16.0: This is now an integer comprised of bit indicators. " +"Was a dictionary previously." +msgstr "" + +#: ../../document.rst:1943 62ee818c5c3d49dcbaee9ca62f93145b +msgid "" +"Contains the permissions to access the document. This is an integer " +"containing bool values in respective bit positions. For example, if " +"*doc.permissions & fitz.PDF_PERM_MODIFY > 0*, you may change the " +"document. See :ref:`PermissionCodes` for details." +msgstr "" + +#: ../../document.rst:1949 3eaf4e8d3e3249c4b73548d00f4df4c7 +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 "" + +#: ../../document.rst:1951 869b3c89ec1e4e42846f062d104db686 +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 "" + +#: ../../document.rst:1953 6b4b2ccc712b461d96aaff5210119738 +msgid "*format* contains the document format (e.g. 'PDF-1.6', 'XPS', 'EPUB')." +msgstr "" + +#: ../../document.rst:1955 99c25df72b7f4cb7beb62d45bf3af4e6 +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 "" + +#: ../../document.rst:1957 ab417c9578ef44d9b3aed39802fa79f4 +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 "" + +#: ../../document.rst:1959 2b6795f133e4478a847c057bd067d6db +msgid "" +" is the 12 character ISO timestamp *YYYYMMDDhhmmss* (*YYYY* - year, " +"*MM* - month, *DD* - day, *hh* - hour, *mm* - minute, *ss* - second), and" +msgstr "" + +#: ../../document.rst:1961 26c172a6eb3340a28d6de38e6a5584de +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 "" + +#: ../../document.rst:1963 2bb85a0c8cf645d98a849dc8754b657b +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 "" + +#: ../../document.rst:1969 0e4c129cb07943e5bb3d7fd6b453aee1 +msgid "" +"Contains the *filename* or *filetype* value with which *Document* was " +"created." +msgstr "" + +#: ../../document.rst:1975 6b5810e7de2845f69e8900700fb2131c +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 "" + +#: ../../document.rst:1981 ../../document.rst:1989 +#: e5ae3f3f161348f08307f79e22d5bf3c fa8213f255af49baad8aa5e49b2114c2 +msgid "New in v1.17.0" +msgstr "" + +#: ../../document.rst:1983 b32f3a555fd54ec8af1a45011a7b69c9 +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 "" + +#: ../../document.rst:1991 2ed09c63b95c4f94a2c9b4c6df271166 +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 "" + +#: ../../document.rst:1997 53a00da15ebd4cc5a74b78011c1796d5 +msgid "" +"A list of form field font names defined in the */AcroForm* object. `None`" +" if not a PDF." +msgstr "" + +#: ../../document.rst:1999 9645ace7058b432789e627d9c9fb131c +msgid "list" +msgstr "" + +#: ../../document.rst:2001 d9d4d61647ee44089a8fdd8052add616 +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 "" + +#: ../../document.rst:2004 c65a795d813749749b1842e1c36f21e7 +msgid ":meth:`set_metadata` Example" +msgstr "" + +#: ../../document.rst:2005 99a646ddf8844b7bafa6cfe96a29eea3 +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 "" + +#: ../../document.rst:2023 28fb80877eea4bdab04f3ac53a808a88 +msgid ":meth:`set_toc` Demonstration" +msgstr "" + +#: ../../document.rst:2024 0e91f533f7d2417cbda08bab8e92d6cc +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 "" + +#: ../../document.rst:2044 27fcf1d3bac24db79bea4142deabbb1c +msgid ":meth:`insert_pdf` Examples" +msgstr "" + +#: ../../document.rst:2045 f131edc184cb420b8597ba3812ffb7bb +msgid "**(1) Concatenate two documents including their TOCs:**" +msgstr "" + +#: ../../document.rst:2057 dcd3b26ac125478a9fe5c848a6948927 +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 "" + +#: ../../document.rst:2059 c0b288150b974561a509eee27870847f +msgid "**(2) More examples:**" +msgstr "" + +#: ../../document.rst:2071 37f5ef67961b450f96be1e7e68538d53 +msgid "Other Examples" +msgstr "" + +#: ../../document.rst:2072 607060228d9946ad852e3d309188888d +msgid "**Extract all page-referenced images of a PDF into separate PNG files**::" +msgstr "" + +#: ../../document.rst:2087 f35cc63cfef842d2b9022a26deea047b +msgid "**Rotate all pages of a PDF:**" +msgstr "" + +#: ../../document.rst:2092 24422de5f37541a2bccbba4e4238f64d +msgid "Footnotes" +msgstr "" + +#: ../../document.rst:2093 22e9ee335bda435893971712dc5ed38e +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 "" + +#: ../../document.rst:2095 3784c86f3f354df0b85606495559a52d +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 "" + +#: ../../document.rst:2097 c3f979674b604546ac1cc75bce1e229e +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 "" + +#: ../../document.rst:2099 cdc23988a1e74870ad4ef5dbbffb8940 +msgid "" +"These parameters cause separate handling of stream categories: use it " +"together with `expand` to restrict decompression to streams other than " +"images / fontfiles." +msgstr "" + +#: ../../document.rst:2101 12f00e6ff90d434db3dd4ccff3de0576 +msgid "Examples for \"Form XObjects\" are created by :meth:`Page.show_pdf_page`." +msgstr "" + +#: ../../document.rst:2103 c9c6d5400d21431eb62994b7fe2b59ca +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 "" + +#: ../../document.rst:2105 eaa755b60a4c48ffb96b41a3d72ca09a +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:-1 fa9a70e56f3f417d9b67bb0ba6813d04 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/faq.mo b/docs/locales/ja/LC_MESSAGES/faq.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/faq.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/faq.po b/docs/locales/ja/LC_MESSAGES/faq.po new file mode 100644 index 000000000..b7dca4da2 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/faq.po @@ -0,0 +1,41 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../faq.rst:7 a2c079c75e8e4a6bb6670f56cde86a8f +msgid "FAQ" +msgstr "" + +#: ../../faq.rst:9 a911f25e964b4911bbf883f91a639957 +msgid "A collection of recipes in “How-To” format for using PyMuPDF." +msgstr "" + +#: ../../faq.rst:12 77d8256a7d8048bb9a4744a5fd5fa257 +msgid "Please see:" +msgstr "" + +#: ../../faq.rst:14 abc472cfb78943f3a2b4c25b00006484 +msgid ":ref:`Recipes: Table of Contents`" +msgstr "" + +#: ../../footer.rst:-1 a7209ac7203b46ac8266860e7ec51e12 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/font.mo b/docs/locales/ja/LC_MESSAGES/font.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/font.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/font.po b/docs/locales/ja/LC_MESSAGES/font.po new file mode 100644 index 000000000..dac5c2a29 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/font.po @@ -0,0 +1,985 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../font.rst:7 0f1b068035ed4e80a8b08e4138c58a02 +msgid "Font" +msgstr "" + +#: ../../font.rst:9 3ad49886f9fa49e88de00b1b8113305c +msgid "New in v1.16.18" +msgstr "" + +#: ../../font.rst:11 40410699a1f5479fbb006049eb97632a +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 "" + +#: ../../font.rst:13 b8731678ee164e05949f9282d1b0cba0 +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.rst:17 8c372f61c735472ba072be07ef58806d +msgid "**Method / Attribute**" +msgstr "" + +#: ../../font.rst:17 f4df5393edbc4b2b844b4fe5be99562b +msgid "**Short Description**" +msgstr "" + +#: ../../font.rst:19 88ca96bb87d54ebdbdd9e88dda2e5220 +msgid ":meth:`~Font.glyph_advance`" +msgstr "" + +#: ../../font.rst:19 a4dcdcf98ef44a0584e8c98cc86036a6 +msgid "Width of a character" +msgstr "" + +#: ../../font.rst:20 979846dbf28a456e96963b3de95069a2 +msgid ":meth:`~Font.glyph_bbox`" +msgstr "" + +#: ../../font.rst:20 80e0f3af10134bdf971a12cfe6dde83b +msgid "Glyph rectangle" +msgstr "" + +#: ../../font.rst:21 10e2c69c04f04924952a83e09283f5ae +msgid ":meth:`~Font.glyph_name_to_unicode`" +msgstr "" + +#: ../../font.rst:21 ff60c4932aff4a9499633bd8584f82b4 +msgid "Get unicode from glyph name" +msgstr "" + +#: ../../font.rst:22 c5f7131a75c34afe82745423b4370b57 +msgid ":meth:`~Font.has_glyph`" +msgstr "" + +#: ../../font.rst:22 b9f700e3f032484791a128ab1d863b54 +msgid "Return glyph id of unicode" +msgstr "" + +#: ../../font.rst:23 f8093fcb05424347b2e8cc8593ba3fc1 +msgid ":meth:`~Font.text_length`" +msgstr "" + +#: ../../font.rst:23 692cbd5da86b4e0d9ee1f39d814c0e31 +msgid "Compute string length" +msgstr "" + +#: ../../font.rst:24 b88cfa697b0f492f89ba54d43e57a1f6 +msgid ":meth:`~Font.char_lengths`" +msgstr "" + +#: ../../font.rst:24 c186370155ad4486a2b1ae75548aa341 +msgid "Tuple of char widths of a string" +msgstr "" + +#: ../../font.rst:25 1a32040a928343a497d10b19a11c29ea +msgid ":meth:`~Font.unicode_to_glyph_name`" +msgstr "" + +#: ../../font.rst:25 ed9691a792bd486994ae32e75e2e60e9 +msgid "Get glyph name of a unicode" +msgstr "" + +#: ../../font.rst:26 6377149545f042a68844869404620a2e +msgid ":meth:`~Font.valid_codepoints`" +msgstr "" + +#: ../../font.rst:26 c1f01268064d4e95b141c730fdbd7880 +msgid "Array of supported unicodes" +msgstr "" + +#: ../../font.rst:27 3137cfab26f24dcb90efa49d5e630c95 +msgid ":attr:`~Font.ascender`" +msgstr "" + +#: ../../font.rst:27 5103705aef6340a593b01e1dd294db8b +msgid "Font ascender" +msgstr "" + +#: ../../font.rst:28 b061fab57bbe40a181f956fea315b5b7 +msgid ":attr:`~Font.descender`" +msgstr "" + +#: ../../font.rst:28 5c3ae9cf49ab4356a46f5c379c82f06a +msgid "Font descender" +msgstr "" + +#: ../../font.rst:29 d5001e7c18434b6eab4f1755081fb2c5 +msgid ":attr:`~Font.bbox`" +msgstr "" + +#: ../../font.rst:29 835d29fe56cd4ddc83a06c032718bee9 +msgid "Font rectangle" +msgstr "" + +#: ../../font.rst:30 5904b1e195e64ee8b831990ce3250f8f +msgid ":attr:`~Font.buffer`" +msgstr "" + +#: ../../font.rst:30 89abb82a22dd40c281dabe71b883fcdc +msgid "Copy of the font's binary image" +msgstr "" + +#: ../../font.rst:31 934b2096d3644f6989bab533538a464d +msgid ":attr:`~Font.flags`" +msgstr "" + +#: ../../font.rst:31 f4d995a95ec7451489f93e7582aa9974 +msgid "Collection of font properties" +msgstr "" + +#: ../../font.rst:32 3b87d1ec4cdb4f9d87a120007e778092 +msgid ":attr:`~Font.glyph_count`" +msgstr "" + +#: ../../font.rst:32 ffbd95ab7f36417186e41d39ad581ea7 +msgid "Number of supported glyphs" +msgstr "" + +#: ../../font.rst:33 802e7afcc7db424ba07a07d65b3da4bb +msgid ":attr:`~Font.name`" +msgstr "" + +#: ../../font.rst:33 c404eb0ac0b54068816491e8899ffb3d +msgid "Name of font" +msgstr "" + +#: ../../font.rst:34 91d6fd040121448db45fb5c7c77f4313 +msgid ":attr:`~Font.is_writable`" +msgstr "" + +#: ../../font.rst:34 d49c8017949f442eba9e92472e938509 +msgid "Font usable with :ref:`TextWriter`" +msgstr "" + +#: ../../font.rst:38 f4688449eee340b6a676ef04e2b7b18d +msgid "**Class API**" +msgstr "" + +#: ../../font.rst:57 846a333d20134d10a49445b3dbba60ba +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 0472bf34c6834d61a9530433f4387580 +#: 339894c0d901480bb2f04742f636cf1c 69b3f8833eec4826884b8040d8ae3dd5 +#: 82ff9bcb4f784979b8ec01ab2a906ce8 b3776e6a1d834d81b034bd5833caf31b +#: c535ca3e6e624c2983d63730597f611a e6c0dfd3280945ff8768249ff29d21d8 +#: ecab34f6badc46e494bd9be9e15b15e6 +msgid "Parameters" +msgstr "" + +#: ../../font.rst:59 41afeca058eb4b3d825f699ff45b9eb1 +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:59 aa085906edf24e6ea2f6c675261f1976 +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 "" + +#: ../../font.rst:61 c794afde364643889598b61c8415ea3a +msgid "*(Changed in v1.17.5)*" +msgstr "" + +#: ../../font.rst:63 da4f12e2eeda4918b287bbe642a68f92 +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 "" + +#: ../../font.rst:65 72b64bbea53c4266aac868abd5b5382a +msgid "the filename of a fontfile somewhere on your system [#f1]_." +msgstr "" + +#: ../../font.rst:66 6abfb7b9849d45f995ce7eb671e7b8a4 +msgid "a fontfile loaded in memory [#f1]_." +msgstr "" + +#: ../../font.rst:67 4190de2ace024fbfb287fc7dd0618d84 +msgid "" +"the number of a UCDN script. Currently supported in PyMuPDF are numbers " +"24, and 32 through 35." +msgstr "" + +#: ../../font.rst:68 0b1ba2bbc9e84ea89664d79f7b64af79 +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 "" + +#: ../../font.rst:69 4860964f65ce46eb9615e551b942e68a +msgid "an alternative selector for one of the CJK fonts." +msgstr "" + +#: ../../font.rst:70 eb69a3d27b25455a8cdff438fa09d908 +msgid "look for a bold font." +msgstr "" + +#: ../../font.rst:71 5609c81bf55042158b048cce2370e772 +msgid "look for an italic font." +msgstr "" + +#: ../../font.rst:72 d3db35f96e3f4402beff440f873189bd +msgid "look for a serifed font." +msgstr "" + +#: ../../font.rst 0edd74de27a54a449fba6e0e64936e5a +#: 11e38f40091d4ff89bf59dbe3bdb2e30 3bc84e333b8c4be596ab09b6d0baaffe +#: 442bb72cdff54aac9b582abd0275c2fd 5a35293121c84b85b363c59a71a7a34a +#: 5b72d138d6f74981a6f0f9186f8748ab 71027cdac9544617be965c745149b2eb +#: 8931de80073443adb2f15493c3a84396 9f2579c073114e589f708287c52759e5 +msgid "Returns" +msgstr "" + +#: ../../font.rst:74 ec169d820ed44f44af6ea896c8540e38 +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:74 41a3b430829243cea599bae70ce1b8e5 +msgid "" +"a MuPDF font if successful. This is the overall sequence of checks to " +"determine an appropriate font:" +msgstr "" + +#: ../../font.rst:77 a19f23e053fd4e54a741c77f34b0ab27 +msgid "Argument" +msgstr "" + +#: ../../font.rst:77 ebb1c92ad5744be8bead1a59f6fad344 +msgid "Action" +msgstr "" + +#: ../../font.rst:79 16b5aa042fd84e8fbab447be377e1ee9 +msgid "fontfile?" +msgstr "" + +#: ../../font.rst:79 e13da5d8301e4533b2b010d80f98e432 +msgid "Create font from file, exception if failure." +msgstr "" + +#: ../../font.rst:80 1569af6b8aaf458084499cf509af288a +msgid "fontbuffer?" +msgstr "" + +#: ../../font.rst:80 72aaf4dd282d4f758c2cb43783bd4303 +msgid "Create font from buffer, exception if failure." +msgstr "" + +#: ../../font.rst:81 6ba827d7f1844988892b78aec69ea78e +msgid "ordering>=0" +msgstr "" + +#: ../../font.rst:81 3af3e8ec83f84a2e8d63e475fe8a4a92 +msgid "Create universal font, always succeeds." +msgstr "" + +#: ../../font.rst:82 19610fb7449e42c3a8abed404c69b787 +msgid "fontname?" +msgstr "" + +#: ../../font.rst:82 3e8fcb305b164b1b9b995f48ffdb471e +msgid "" +"Create a Base-14 font, universal font, or font provided by `pymupdf-fonts" +" `_. See table below." +msgstr "" + +#: ../../font.rst:89 7932fe926a664922baee088c95c4513e +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 "" + +#: ../../font.rst:91 03fbf6c2f7f646418d6432dbea98a283 +msgid "a font file will **always** be embedded in your PDF," +msgstr "" + +#: ../../font.rst:92 add2657a4b54402fbb12204e5e0a6d50 +msgid "" +"Greek and Cyrillic characters are supported without needing the " +"*encoding* parameter." +msgstr "" + +#: ../../font.rst:94 1fe49d11e7d947dd94bcf3ebdd912981 +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 "" + +#: ../../font.rst:96 21ad45638a8b4eb5ae7f87a3aea252f0 +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 "" + +#: ../../font.rst:98 5f7ba24ec0344fa895d361d02264ca33 +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 "" + +#: ../../font.rst:100 f74eace960384ea09b3ec1c850d59479 +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 "" + +#: ../../font.rst:102 0ca62477b9eb4aaeb498a1e6b625af5d +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 "" + +#: ../../font.rst:104 b810a959710b40bf84865f695dda0053 +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 "" + +#: ../../font.rst:106 bbb78352c0124b0c93987cc9f310c1a6 +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:109 6da6cd8c39bf467e87aa484b95737323 +msgid "Code" +msgstr "" + +#: ../../font.rst:109 a5f700ce67424d81a2d390de5fa3b8c3 +msgid "Fontname" +msgstr "" + +#: ../../font.rst:109 9599eba8d6624fe9af6e3aae3d64542c +msgid "New in" +msgstr "" + +#: ../../font.rst:109 247c4be0fd224e2c93b0b1708dfa49ca +msgid "Comment" +msgstr "" + +#: ../../font.rst:111 ed91d6b492a2448c8074cf8326806e30 +msgid "figo" +msgstr "" + +#: ../../font.rst:111 05d13b253cb0451fb04099af9fe19b02 +msgid "FiraGO Regular" +msgstr "" + +#: ../../font.rst:111 ../../font.rst:112 ../../font.rst:113 ../../font.rst:114 +#: ../../font.rst:115 ../../font.rst:116 1a0413570add4f7ebc4cfbc5b4c326d3 +#: 2749fdc30e3343fa8c641b995c9c23ce 38584f80e4854307a5e56b68b7928017 +#: 6cb88e2cc42d42ba833a45d6a5fe24b3 e6c8773c2d734ce591019eacf27e3753 +#: f7d0196f64d643d5a4a0a5db9d2264d1 +msgid "v1.0.0" +msgstr "" + +#: ../../font.rst:111 67ace3b4124e4ba0a6a191fdfe586b75 +msgid "narrower than Helvetica" +msgstr "" + +#: ../../font.rst:112 d9c2a21b037142148a23709c7030e769 +msgid "figbo" +msgstr "" + +#: ../../font.rst:112 9cb1bfb909104c94b7199e14504ee756 +msgid "FiraGO Bold" +msgstr "" + +#: ../../font.rst:113 13d28d65156b430da227fdcd656b1a6c +msgid "figit" +msgstr "" + +#: ../../font.rst:113 0395e71c1dcb4307b9dfd768f562cf7e +msgid "FiraGO Italic" +msgstr "" + +#: ../../font.rst:114 fef946249727433b91c9bc526beedb42 +msgid "figbi" +msgstr "" + +#: ../../font.rst:114 4fed419b930c4953a78133aedb133ce3 +msgid "FiraGO Bold Italic" +msgstr "" + +#: ../../font.rst:115 736c344e44ba436d9a21284f57a39662 +msgid "fimo" +msgstr "" + +#: ../../font.rst:115 697f55a5ae4a42b68c5b4026949a04ae +msgid "Fira Mono Regular" +msgstr "" + +#: ../../font.rst:116 638b3ada9c9248ca8cd3e1392fa04f97 +msgid "fimbo" +msgstr "" + +#: ../../font.rst:116 5e32301a4aa44d01ad07b13694410121 +msgid "Fira Mono Bold" +msgstr "" + +#: ../../font.rst:117 e2235fe36b1a4ffba175fd452f098fe2 +msgid "spacemo" +msgstr "" + +#: ../../font.rst:117 23451c895d6a47f7b80df16f8fe5e703 +msgid "Space Mono Regular" +msgstr "" + +#: ../../font.rst:117 ../../font.rst:118 ../../font.rst:119 ../../font.rst:120 +#: 00ca8b1b51e14808a8098276c8f06c96 261f2d4739764bae96eed4a5e9b65753 +#: 2b507c98e404484e9b73fd0ee74f61ca 5962e3cd183e4383b9d6da2bae742b76 +msgid "v1.0.1" +msgstr "" + +#: ../../font.rst:118 c97ab9913ced4673af00d8ab96d86445 +msgid "spacembo" +msgstr "" + +#: ../../font.rst:118 4751a7fe53d54bd7a913a5dfd73eafd8 +msgid "Space Mono Bold" +msgstr "" + +#: ../../font.rst:119 2ecb762ffa2d4381bad0af46d64452df +msgid "spacemit" +msgstr "" + +#: ../../font.rst:119 c3c897634cd04a67a094a2b383562c10 +msgid "Space Mono Italic" +msgstr "" + +#: ../../font.rst:120 d9fdbd010e2b413aaaf7b8fb24df689a +msgid "spacembi" +msgstr "" + +#: ../../font.rst:120 2214e116e2724dd686248ebe72cf0d4d +msgid "Space Mono Bold-Italic" +msgstr "" + +#: ../../font.rst:121 5200b2f7204347cba7a21a32bd7ed118 +msgid "math" +msgstr "" + +#: ../../font.rst:121 a2a38749cfc64a3183c0fd7612fa08d7 +msgid "Noto Sans Math Regular" +msgstr "" + +#: ../../font.rst:121 ../../font.rst:122 ../../font.rst:123 ../../font.rst:124 +#: 15ff98597151449d816b45b809de6a91 813a0e7743144f2eb539696f322172f5 +#: 9be92d6d16614d70a51fc58928aba348 d257c4684e374fa7b0955403f88347e1 +msgid "v1.0.2" +msgstr "" + +#: ../../font.rst:121 4da5f262ea704269b09f2dd1cc389fbe +msgid "math symbols" +msgstr "" + +#: ../../font.rst:122 af4851df30884125ac35415b3a29e769 +msgid "music" +msgstr "" + +#: ../../font.rst:122 61e8619e4dc44ffd8098d36943c1e3ff +msgid "Noto Music Regular" +msgstr "" + +#: ../../font.rst:122 e293939433844b1ba06099330f6a2f58 +msgid "musical symbols" +msgstr "" + +#: ../../font.rst:123 605763008ad34180b1337fdcfdde1d10 +msgid "symbol1" +msgstr "" + +#: ../../font.rst:123 2283004c6f4543ac92239c84be4eb1e8 +msgid "Noto Sans Symbols Regular" +msgstr "" + +#: ../../font.rst:123 77893a7cfa4341e7b4763caa74a47fc4 +msgid "replacement for \"symb\"" +msgstr "" + +#: ../../font.rst:124 cdabdffe349b4409a96815353d5f086a +msgid "symbol2" +msgstr "" + +#: ../../font.rst:124 a28c00922df14a878afabc465fdd89d3 +msgid "Noto Sans Symbols2 Regular" +msgstr "" + +#: ../../font.rst:124 45b6c66e1188478cb500f0c159502d67 +msgid "extended symbol set" +msgstr "" + +#: ../../font.rst:125 aadc3b1747b041dc8cec726fee63b2c9 +msgid "notos" +msgstr "" + +#: ../../font.rst:125 8c62f22dac2f46b586649eb55eef97e7 +msgid "Noto Sans Regular" +msgstr "" + +#: ../../font.rst:125 ../../font.rst:126 ../../font.rst:127 ../../font.rst:128 +#: 70458ff7a57c4ddd90007e3583126473 82fb1080aa7344da9091b195c0db6338 +#: c5edf1c06ddf496bab45827541f2654a ded54d35c71248faa610cee308891ff6 +msgid "v1.0.3" +msgstr "" + +#: ../../font.rst:125 2e66932b417d453c860ff5cad53423ab +msgid "alternative to Helvetica" +msgstr "" + +#: ../../font.rst:126 f3ee29df2d92492b9583655c8536b63a +msgid "notosit" +msgstr "" + +#: ../../font.rst:126 cf05937edf4843169a31de5f8271dc4a +msgid "Noto Sans Italic" +msgstr "" + +#: ../../font.rst:127 91f4be00627e4f0baafd7c36cf2e236b +msgid "notosbo" +msgstr "" + +#: ../../font.rst:127 f74dfb6af0c74138aed76209bfc037c7 +msgid "Noto Sans Bold" +msgstr "" + +#: ../../font.rst:128 b030c7497bb043ae8e5f6064095ef094 +msgid "notosbi" +msgstr "" + +#: ../../font.rst:128 206bfb38eee642be839af587ef345664 +msgid "Noto Sans BoldItalic" +msgstr "" + +#: ../../font.rst:138 4e288e23a60a48b6a39274690d6418e2 +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 "" + +#: ../../font.rst:140 ffa3e9079c974165accbfb18463d6891 +msgid "the unicode of the character (i.e. *ord()*)." +msgstr "" + +#: ../../font.rst:141 cff97c5373484ea59809fa75e7f0312f +msgid "the language -- currently unused." +msgstr "" + +#: ../../font.rst:142 146f430a6ef7437aafd375274e885110 +msgid "the UCDN script number." +msgstr "" + +#: ../../font.rst:143 d42b27a0d3a549e7be21a3e0305119ec +msgid "" +"*(new in v1.17.5)* perform an extended search in fallback fonts or " +"restrict to current font (default)." +msgstr "" + +#: ../../font.rst:144 3cb57fc277aa4ec9bc1785d047d26dae +msgid "*(changed in 1.17.7)* the glyph number. Zero indicates no glyph found." +msgstr "" + +#: ../../font.rst:148 5bf903c54a91412e8ead4ee0777f5a90 +msgid "New in v1.17.5" +msgstr "" + +#: ../../font.rst:150 26e3760936ff4f7d83cee7756c16d159 +msgid "Return an array of unicodes supported by this font." +msgstr "" + +#: ../../font.rst:152 b3297d400fdf46c9a7b3cd1ec17a0c3c +#, 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 fitz >>> font = fitz.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:152 6b02cafc3ca74e259884268f95445855 +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 "" + +#: ../../font.rst:180 268a72e3f5ee4bebab20c0bedf532d85 +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 "" + +#: ../../font.rst:189 e968deab9e5346318605f5058c9f431c +msgid "Calculate the \"width\" of the character's glyph (visual representation)." +msgstr "" + +#: ../../font.rst:191 af3767b4a1dd4c44a8b18e1613ceeafa +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 "" + +#: ../../font.rst:192 75dfa97a57f24aad8bc2d7bb789adf04 +msgid "write mode, 0 = horizontal, 1 = vertical." +msgstr "" + +#: ../../font.rst:194 9910bf2a31254defa7fec83bcab24ca2 +msgid "The other parameters are not in use currently." +msgstr "" + +#: ../../font.rst:196 979861ecd1c240ba89646763eb1398f7 +msgid "a float representing the glyph's width relative to **fontsize 1**." +msgstr "" + +#: ../../font.rst:200 03dc7eb3c471401b940e0402c47e70e5 +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 "" + +#: ../../font.rst:202 82bb20f132ac411ebaa61ffa29aa7309 +msgid "The name of the glyph." +msgstr "" + +#: ../../font.rst:204 e631b0d42ffc4121a6d42d63a1c87260 +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 = fitz.Font(\"helv\") >>> " +"font.has_glyph(font.glyph_name_to_unicode(\"infinity\")) True" +msgstr "" + +#: ../../font.rst:204 d395b932e89e4aafac25bbdac15ac96d +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 "" + +#: ../../font.rst:216 01841d9d54c6440b86da4dd61134c34e +msgid "The glyph rectangle relative to fontsize 1." +msgstr "" + +#: ../../font.rst:218 23e9e39445d04e7e9fcc2458d9d39436 +msgid "*ord()* of the character." +msgstr "" + +#: ../../font.rst:220 e1bc1b1f021b4cc4b1419bd93713402b +msgid "a :ref:`Rect`." +msgstr "" + +#: ../../font.rst:225 ecd256061ffb45c5b3cd6890e14cde04 +msgid "Show the name of the character's glyph." +msgstr "" + +#: ../../font.rst:227 d6e51f1ad9f34a63971a6d2d190433b6 +msgid "" +"the unicode number of the character. Use *ord()*, not the character " +"itself." +msgstr "" + +#: ../../font.rst:229 772649e5005e4e46a4d7fdd52497cd45 +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 " +"`fitz.unicode_to_glyph_name()` and resp. `fitz.glyph_name_to_unicode()`." +msgstr "" + +#: ../../font.rst:229 a7387dc2d4884668aea612c41e3db343 +msgid "" +"a string representing the glyph's name. E.g. `font.glyph_name(ord(\"#\"))" +" = \"numbersign\"`. For an invalid code \".notfound\" is returned." +msgstr "" + +#: ../../font.rst:231 37611262109b409dba31063936edcc41 +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 `fitz.unicode_to_glyph_name()` " +"and resp. `fitz.glyph_name_to_unicode()`." +msgstr "" + +#: ../../font.rst:238 9295dc25b2f944e8b5a2a5674e29ed51 +msgid "Calculate the length in points of a unicode string." +msgstr "" + +#: ../../font.rst:240 6c519a7146684090a7860088ca670236 +msgid "" +"There is a functional overlap with :meth:`get_text_length` for Base-14 " +"fonts only." +msgstr "" + +#: ../../font.rst:242 ../../font.rst:266 92eead0f598e48d1b3c8e6b3c7065dd4 +#: 93bafdbaec9349109ad70759b45319e3 +msgid "a text string, UTF-8 encoded." +msgstr "" + +#: ../../font.rst:244 ../../font.rst:268 a6dcc6c9b347456591be94f9afe41fb6 +#: cbdf315acd4e429693e8790b1e2c7ca6 +msgid "the fontsize." +msgstr "" + +#: ../../font.rst 0ef94501afc34963afd3cd1a7ef48682 +#: 12f0d213d48541e9aae8534d297bd2f5 17c3fd2042d940e3a5d41c178172ccac +#: 5b6b0ffaae404e95a4a0c3a0cc73ffa6 9122f7f4bb074a049623d9939d62f23d +#: 9a1de1fa0a95456581f63adfa4cf22c8 c33f1059940648a79e2e67937bdd9bb1 +#: dc756d21a3de4b9587c41cfeb752925a f6c5823e31954b009e6e8a63843aef19 +#: fb34a14b8a374cd2bc3519f8f469668d +msgid "Return type" +msgstr "" + +#: ../../font.rst:248 67ee1ae9e561434eba9dd38f37efb498 +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:248 2f8a789591c5454bb6287393b42e173b +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 "" + +#: ../../font.rst:250 e5dff0ff8564455285ca279e35848c43 +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 "" + +#: ../../font.rst:252 20f2bb793d474646a681824b80e01c33 +msgid "`font.glyph_advance(ord(\"Ä\")) * fontsize`" +msgstr "" + +#: ../../font.rst:253 4cce4280c4c347e3b284093dcaac9118 +msgid "`font.text_length(\"Ä\", fontsize=fontsize)`" +msgstr "" + +#: ../../font.rst:255 f812cc5c11c24e88933cb328c0a041e7 +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 "" + +#: ../../font.rst:262 57f6363d83ee4506ab99166c87d8a5de +msgid "*New in v1.18.14*" +msgstr "" + +#: ../../font.rst:264 4e10f79271964e99bec8aa2584097b66 +msgid "Sequence of character lengths in points of a unicode string." +msgstr "" + +#: ../../font.rst:272 bca913adbd2b4608b33672ee47e805f9 +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 = fitz.Font(\"helv\") >>> text = \"PyMuPDF\" >>> " +"font.text_length(text) 50.115999937057495 >>> fitz.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:272 66b4b12087484b67bbc59165e2587ab3 +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 "" + +#: ../../font.rst:294 b9df4ca22c9b46f1876abb3d39bdd72a +msgid "New in v1.17.6" +msgstr "" + +#: ../../font.rst:296 fd1df5d1ee3d4f17aa30c38d3088f0e5 +msgid "Copy of the binary font file content." +msgstr "" + +#: ../../font.rst:302 6ba599d561624a9f9488c1bbcc64dc6f +msgid "" +"A dictionary with various font properties, each represented as bools. " +"Example for Helvetica::" +msgstr "" + +#: ../../font.rst:322 e8cebffad3854e98bc633b49f3b3b6b6 +msgid "Name of the font. May be \"\" or \"(null)\"." +msgstr "" + +#: ../../font.rst:326 6cd4b80eba8b4308810cdf575e01b2f5 +msgid "The font bbox. This is the maximum of its glyph bboxes." +msgstr "" + +#: ../../font.rst:328 f2af08eec3314c87959c8b9eb3c0a5cb +msgid ":ref:`Rect`" +msgstr "" + +#: ../../font.rst:334 a41a3d21cd6e4be79ab947ef7d01310e +msgid "The number of glyphs defined in the font." +msgstr "" + +#: ../../font.rst:338 ../../font.rst:346 ../../font.rst:354 +#: 19e23c4f9b814e218e0acb157f329b02 269c9ce76cca40ccb5c407c68e6681dd +#: 9ed73f1637d74a79b9ad76b569d21316 +msgid "New in v1.18.0" +msgstr "" + +#: ../../font.rst:340 1e0c9b621992440f91baa84b94d64785 +msgid "" +"The ascender value of the font, see `here " +"`_ 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 "" + +#: ../../font.rst:348 8683bf7932284c2cbf2232edfb85f5d2 +msgid "" +"The descender value of the font, see `here " +"`_ 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 "" + +#: ../../font.rst:356 167e00196d734682aaa043da874c452f +msgid "Indicates whether this font can be used with :ref:`TextWriter`." +msgstr "" + +#: ../../font.rst:361 80f665343e0e4ed3b1a56a9f5985fa96 +msgid "Footnotes" +msgstr "" + +#: ../../font.rst:362 89601d36d49c4d66af2cc0b1dfe35699 +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. The :ref:`TextWriter` methods check " +":attr:`Font.is_writable`." +msgstr "" + +#: ../../font.rst:364 6d18c2769ab14c96915aa2886e679884 +msgid "" +"The built-in module *array* has been chosen for its speed and its compact" +" representation of values." +msgstr "" + +#: ../../footer.rst:-1 70caca08324041d3b8b9462ebb6811b3 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/footer.mo b/docs/locales/ja/LC_MESSAGES/footer.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/footer.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/footer.po b/docs/locales/ja/LC_MESSAGES/footer.po new file mode 100644 index 000000000..815622ddd --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/footer.po @@ -0,0 +1,25 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../footer.rst:-1 dbc5963128634997b5c995dc0903378b +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/functions.mo b/docs/locales/ja/LC_MESSAGES/functions.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/functions.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/functions.po b/docs/locales/ja/LC_MESSAGES/functions.po new file mode 100644 index 000000000..19b6baac8 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/functions.po @@ -0,0 +1,1960 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../functions.rst:5 e4e2d25879c1420a9b98a9fc75c9d6ee +msgid "Functions" +msgstr "" + +#: ../../functions.rst:6 62588b0de22548609e7edd2755cd387c +msgid "" +"The following are miscellaneous functions and attributes on a fairly low-" +"level technical detail." +msgstr "" + +#: ../../functions.rst:8 fdf33dda97684713a930c0e367cac81c +msgid "" +"Some functions provide detail access to PDF structures. Others are " +"stripped-down, high performance versions of other functions which provide" +" more information." +msgstr "" + +#: ../../functions.rst:10 80466f051b2f4c9e972b2ec23279e60a +msgid "Yet others are handy, general-purpose utilities." +msgstr "" + +#: ../../functions.rst:14 885703a458d44b1fbfa287c4e7c32ce1 +msgid "**Function**" +msgstr "" + +#: ../../functions.rst:14 0782ad6449f4480d9f4da20a378ea5db +msgid "**Short Description**" +msgstr "" + +#: ../../functions.rst:16 f4ebe592dd4c4ce691eda8aa2350f485 +msgid ":attr:`Annot.apn_bbox`" +msgstr "" + +#: ../../functions.rst:16 636d672f08874796bc7ba350510500cf +msgid "PDF only: bbox of the appearance object" +msgstr "" + +#: ../../functions.rst:17 547e07332168477193bb1d055bd6d5a7 +msgid ":attr:`Annot.apn_matrix`" +msgstr "" + +#: ../../functions.rst:17 6a3f580dcee6462f9ad21ddf2cfcd037 +msgid "PDF only: the matrix of the appearance object" +msgstr "" + +#: ../../functions.rst:18 c56d1af3b4ab42eb95c75a9fd2cf417b +msgid ":attr:`Page.is_wrapped`" +msgstr "" + +#: ../../functions.rst:18 a3292414bdad41c18f38879294b65e61 +msgid "check whether contents wrapping is present" +msgstr "" + +#: ../../functions.rst:19 2d8275e2eb9f4f7dbe6b8706f3c43d5c +msgid ":meth:`adobe_glyph_names`" +msgstr "" + +#: ../../functions.rst:19 b4e133da633841e3bcc5422875703bbe +msgid "list of glyph names defined in **Adobe Glyph List**" +msgstr "" + +#: ../../functions.rst:20 5633eeb23647473fa21d0aadec83d553 +msgid ":meth:`adobe_glyph_unicodes`" +msgstr "" + +#: ../../functions.rst:20 3592b9ee34154b8fa4b9386e0ca445e8 +msgid "list of unicodes defined in **Adobe Glyph List**" +msgstr "" + +#: ../../functions.rst:21 e09a5165008c44449e5782cb92015006 +msgid ":meth:`Annot.clean_contents`" +msgstr "" + +#: ../../functions.rst:21 900613115f484d6598b03d7bb510e11c +msgid "PDF only: clean the annot's :data:`contents` object" +msgstr "" + +#: ../../functions.rst:22 8d00a7bc82d44c64b1077a6f0913d14b +msgid ":meth:`Annot.set_apn_bbox`" +msgstr "" + +#: ../../functions.rst:22 ea682034313b441abf72d2ffb1a93754 +msgid "PDF only: set the bbox of the appearance object" +msgstr "" + +#: ../../functions.rst:23 041792b9993e4c36806d0d6d4a767216 +msgid ":meth:`Annot.set_apn_matrix`" +msgstr "" + +#: ../../functions.rst:23 16b6b63d1a834ac4bd66f8d654b42d5a +msgid "PDF only: set the matrix of the appearance object" +msgstr "" + +#: ../../functions.rst:24 437cbe9898dc40b3a92eae273f8476fb +msgid ":meth:`ConversionHeader`" +msgstr "" + +#: ../../functions.rst:24 056bdd2614b04100b1984286233b3881 +msgid "return header string for *get_text* methods" +msgstr "" + +#: ../../functions.rst:25 cb592a2a93ae42adb18f628fe93555d8 +msgid ":meth:`ConversionTrailer`" +msgstr "" + +#: ../../functions.rst:25 71002639b46546f0a7fa353df68d49bc +msgid "return trailer string for *get_text* methods" +msgstr "" + +#: ../../functions.rst:26 ba0be81e8d9149ff8daeedf1cd130135 +msgid ":meth:`Document.del_xml_metadata`" +msgstr "" + +#: ../../functions.rst:26 d467e7953f59458e85d03983a126cb52 +msgid "PDF only: remove XML metadata" +msgstr "" + +#: ../../functions.rst:27 6414e54e60894e1180ddc78e0eebfdc7 +msgid ":meth:`Document.get_char_widths`" +msgstr "" + +#: ../../functions.rst:27 e982aacc26f34e8ca6e6555de09dd146 +msgid "PDF only: return a list of glyph widths of a font" +msgstr "" + +#: ../../functions.rst:28 7b55b7f9a64345f889ad3df34b6dd169 +msgid ":meth:`Document.get_new_xref`" +msgstr "" + +#: ../../functions.rst:28 6ee1e77e902c44299c1b5418287211f3 +msgid "PDF only: create and return a new :data:`xref` entry" +msgstr "" + +#: ../../functions.rst:29 575f9f4af78a4985b2cfd5186ad12336 +msgid ":meth:`Document.is_stream`" +msgstr "" + +#: ../../functions.rst:29 b8791f0402b64971805146cbfcf90d46 +msgid "PDF only: check whether an :data:`xref` is a stream object" +msgstr "" + +#: ../../functions.rst:30 bd3ad5d7913f4f0db1f33bc89251239e +msgid ":meth:`Document.xml_metadata_xref`" +msgstr "" + +#: ../../functions.rst:30 f32af3e893784306b04d12954f3e33d5 +msgid "PDF only: return XML metadata :data:`xref` number" +msgstr "" + +#: ../../functions.rst:31 87c013f106db4776b47d79e26fb0736a +msgid ":meth:`Document.xref_length`" +msgstr "" + +#: ../../functions.rst:31 e1e46e451b29432a9ee85e63c45a0690 +msgid "PDF only: return length of :data:`xref` table" +msgstr "" + +#: ../../functions.rst:32 17fed09455614424aa92d84676964719 +msgid ":meth:`EMPTY_IRECT`" +msgstr "" + +#: ../../functions.rst:32 ../../functions.rst:34 +#: 2839c020586e494d91638d1ae87da7f1 c3dc81bbc6334b6e8ccb127215f02116 +msgid "return the (standard) empty / invalid rectangle" +msgstr "" + +#: ../../functions.rst:33 29e153e64c584ab98369209e5ce704ff +msgid ":meth:`EMPTY_QUAD`" +msgstr "" + +#: ../../functions.rst:33 0c9e33be00054afa9f7e4cdc65e282c0 +msgid "return the (standard) empty / invalid quad" +msgstr "" + +#: ../../functions.rst:34 771ca37d322348acaa17af7910cdb96d +msgid ":meth:`EMPTY_RECT`" +msgstr "" + +#: ../../functions.rst:35 68f97aa84340417ab570b66f0a29c994 +msgid ":meth:`get_pdf_now`" +msgstr "" + +#: ../../functions.rst:35 c6955d9476394bafbb14b7e4efb10cc8 +msgid "return the current timestamp in PDF format" +msgstr "" + +#: ../../functions.rst:36 9775051cd35648468233f985d1832652 +msgid ":meth:`get_pdf_str`" +msgstr "" + +#: ../../functions.rst:36 86f21731ede545d697489ddbc9ada6f8 +msgid "return PDF-compatible string" +msgstr "" + +#: ../../functions.rst:37 f15895e506ab403499574eef3a6e42d0 +msgid ":meth:`get_text_length`" +msgstr "" + +#: ../../functions.rst:37 a0b8b3192b4d4f31940e2c6f7ba049de +msgid "return string length for a given font & fontsize" +msgstr "" + +#: ../../functions.rst:38 b4fc08398dd248c3b7112191da56a779 +msgid ":meth:`glyph_name_to_unicode`" +msgstr "" + +#: ../../functions.rst:38 fa98a9ec00e04afa98556460a308133f +msgid "return unicode from a glyph name" +msgstr "" + +#: ../../functions.rst:39 c00bfabeb5bc40a0952b3c90d5a72fc0 +msgid ":meth:`image_profile`" +msgstr "" + +#: ../../functions.rst:39 08f5a2f531e7477984fd8d879896b81c +msgid "return a dictionary of basic image properties" +msgstr "" + +#: ../../functions.rst:40 ab0679c20b2a41fba87964192aedcd66 +msgid ":meth:`INFINITE_IRECT`" +msgstr "" + +#: ../../functions.rst:40 ../../functions.rst:42 +#: 0e51d3a8f0ff4b8a97c51539a37cae80 bed4f733b41b47b1a5254fb2fd1cab02 +msgid "return the (only existing) infinite rectangle" +msgstr "" + +#: ../../functions.rst:41 1d7554002d5745ca88f3491346334698 +msgid ":meth:`INFINITE_QUAD`" +msgstr "" + +#: ../../functions.rst:41 b472417b8c5b4b2a807474f95467b21e +msgid "return the (only existing) infinite quad" +msgstr "" + +#: ../../functions.rst:42 f7014ea5288a48c3b24eb66735915424 +msgid ":meth:`INFINITE_RECT`" +msgstr "" + +#: ../../functions.rst:43 e7f7d6a7df3643b2b6e6ec021458d6b3 +msgid ":meth:`make_table`" +msgstr "" + +#: ../../functions.rst:43 1a983e9f4404433fb874b951abd184bb +msgid "split rectangle in sub-rectangles" +msgstr "" + +#: ../../functions.rst:44 2007a372d37e4660bd78818a0d727e92 +msgid ":meth:`Page.clean_contents`" +msgstr "" + +#: ../../functions.rst:44 aac6ea39141e41d9bcc7f8bafadd7b19 +msgid "PDF only: clean the page's :data:`contents` objects" +msgstr "" + +#: ../../functions.rst:45 62b85b409d184213908c1d1ff00fd4ee +msgid ":meth:`Page.get_bboxlog`" +msgstr "" + +#: ../../functions.rst:45 a5ae43e1dbc8432080711a1d6d46d8be +msgid "list of rectangles that envelop text, drawing or image objects" +msgstr "" + +#: ../../functions.rst:46 12d93d3494674e5093f582797076a138 +msgid ":meth:`Page.get_contents`" +msgstr "" + +#: ../../functions.rst:46 305055ca7b28401a97d8b44c70722d1d +msgid "PDF only: return a list of content :data:`xref` numbers" +msgstr "" + +#: ../../functions.rst:47 94a4793289484b3caf4b281858b1f710 +msgid ":meth:`Page.get_displaylist`" +msgstr "" + +#: ../../functions.rst:47 697befb3171f46da96bf951014c5530b +msgid "create the page's display list" +msgstr "" + +#: ../../functions.rst:48 b2b82e45a7754fd69d75e2d7270be56d +msgid ":meth:`Page.get_text_blocks`" +msgstr "" + +#: ../../functions.rst:48 6bc42ab4c2584dfd8646ad47e091db38 +msgid "extract text blocks as a Python list" +msgstr "" + +#: ../../functions.rst:49 7875f3c65abc450eaa486e29fab30d6a +msgid ":meth:`Page.get_text_words`" +msgstr "" + +#: ../../functions.rst:49 8019b20070214ea7afdcdedeb65e540f +msgid "extract text words as a Python list" +msgstr "" + +#: ../../functions.rst:50 9c5ccb2b902248ed9a56a71b8df0d9ca +msgid ":meth:`Page.get_texttrace`" +msgstr "" + +#: ../../functions.rst:50 8c8ca3f6f9e7417595575e6b439679ee +msgid "low-level text information" +msgstr "" + +#: ../../functions.rst:51 78451f7120834815b3451865ea8eefd5 +msgid ":meth:`Page.read_contents`" +msgstr "" + +#: ../../functions.rst:51 4d2a48fcf6d24b17a042e8148b760e8b +msgid "PDF only: get complete, concatenated /Contents source" +msgstr "" + +#: ../../functions.rst:52 2e18baf3087f46d0818d2af8cb539d32 +msgid ":meth:`Page.run`" +msgstr "" + +#: ../../functions.rst:52 ec45206905b94e0d82c595224accb792 +msgid "run a page through a device" +msgstr "" + +#: ../../functions.rst:53 323490a802d94bb3b47088a6bf1d63b1 +msgid ":meth:`Page.set_contents`" +msgstr "" + +#: ../../functions.rst:53 0ad86ecb86c64e249e02f67ef0184cb2 +msgid "PDF only: set page's :data:`contents` to some :data:`xref`" +msgstr "" + +#: ../../functions.rst:54 5529f58a3323402cabfe691a3cd43b62 +msgid ":meth:`Page.wrap_contents`" +msgstr "" + +#: ../../functions.rst:54 33b8c98d2abc4c0582de621d15f14cdf +msgid "wrap contents with stacking commands" +msgstr "" + +#: ../../functions.rst:55 bca1d3a485a3422bb648fbeb7f3be341 +msgid ":meth:`css_for_pymupdf_font`" +msgstr "" + +#: ../../functions.rst:55 88d77163434e486ea961da6b2e067b12 +msgid "create CSS source for a font in package pymupdf_fonts" +msgstr "" + +#: ../../functions.rst:56 c62845bd9f9a4771af81aa8f37afafd0 +msgid ":meth:`paper_rect`" +msgstr "" + +#: ../../functions.rst:56 61bda9c4e9c5408d8d346432065517a0 +msgid "return rectangle for a known paper format" +msgstr "" + +#: ../../functions.rst:57 fef14c7662b544d5ba3afe952037224c +msgid ":meth:`paper_size`" +msgstr "" + +#: ../../functions.rst:57 b3e6b1e33d7a4faf98d1a4ca0138ebbe +msgid "return width, height for a known paper format" +msgstr "" + +#: ../../functions.rst:58 d3c3b33051d24a5c9f001502c037c686 +msgid ":meth:`paper_sizes`" +msgstr "" + +#: ../../functions.rst:58 3daa749058c741e29655e21a559ae579 +msgid "dictionary of pre-defined paper formats" +msgstr "" + +#: ../../functions.rst:59 1308e116adf7404cafd60ad4e9d682f3 +msgid ":meth:`planish_line`" +msgstr "" + +#: ../../functions.rst:59 c409e1eea3824e48889ba01887568017 +msgid "matrix to map a line to the x-axis" +msgstr "" + +#: ../../functions.rst:60 1b721f00708e4b8cbc70874272912445 +msgid ":meth:`recover_char_quad`" +msgstr "" + +#: ../../functions.rst:60 1a7d5777cf9f4ec28eb08a451cae45b1 +msgid "compute the quad of a char (\"rawdict\")" +msgstr "" + +#: ../../functions.rst:61 d98f6d25938e40ca88229729a92490e9 +msgid ":meth:`recover_line_quad`" +msgstr "" + +#: ../../functions.rst:61 4b05ef3d51ca40779a292baa03c129d3 +msgid "compute the quad of a subset of line spans" +msgstr "" + +#: ../../functions.rst:62 ../../functions.rst:63 +#: 3be2152b58cd42969a37b397d9914c11 c3e075a190b74658be42322b18ccafd5 +msgid ":meth:`recover_quad`" +msgstr "" + +#: ../../functions.rst:62 1ea9446bbad24c799035fba66328c2a5 +msgid "compute the quad of a span (\"dict\", \"rawdict\")" +msgstr "" + +#: ../../functions.rst:63 0888cae30b11404eaf958b822620b305 +msgid "return the quad for a text span (\"dict\" / \"rawdict\")" +msgstr "" + +#: ../../functions.rst:64 22b284bfbecd45ab8d5deb15c7aaae6d +msgid ":meth:`recover_span_quad`" +msgstr "" + +#: ../../functions.rst:64 c2101f97f42a45a6ae96ca532d369893 +msgid "compute the quad of a subset of span characters" +msgstr "" + +#: ../../functions.rst:65 fd5f1f5f384847c0b32986f03067c57a +msgid ":meth:`sRGB_to_pdf`" +msgstr "" + +#: ../../functions.rst:65 923d07de68b44f4dab8fb38d28212048 +msgid "return PDF RGB color tuple from an sRGB integer" +msgstr "" + +#: ../../functions.rst:66 1e215fcab2c545c08abbc04ba83ffdc4 +msgid ":meth:`sRGB_to_rgb`" +msgstr "" + +#: ../../functions.rst:66 fa7b95eb1ff94c5c95deb50946432f82 +msgid "return (R, G, B) color tuple from an sRGB integer" +msgstr "" + +#: ../../functions.rst:67 313543e58fb4485b9e5a38fbb78d8fbf +msgid ":meth:`unicode_to_glyph_name`" +msgstr "" + +#: ../../functions.rst:67 ab58f6edf4a44d06bef1bb85b2ff8440 +msgid "return glyph name from a unicode" +msgstr "" + +#: ../../functions.rst:68 9a7a22c918b042a3ad7d8d53429c157e +msgid ":meth:`get_tessdata`" +msgstr "" + +#: ../../functions.rst:68 20dd097cf4fa4d21b638fdef60865fae +msgid "locates the language support of the Tesseract-OCR installation" +msgstr "" + +#: ../../functions.rst:69 c64c9489b41c4e9b9a40753ced6e63a0 +msgid ":attr:`fitz_fontdescriptors`" +msgstr "" + +#: ../../functions.rst:69 1a3b4c8f639b4d0e91ecc4f5cc698881 +msgid "dictionary of available supplement fonts" +msgstr "" + +#: ../../functions.rst:70 650f50ba50cc4b27ab5bedfc8e9b1d24 +msgid ":attr:`TESSDATA_PREFIX`" +msgstr "" + +#: ../../functions.rst:70 19b76233d65a4432b369ef417cae3fe3 +msgid "a copy of `os.environ[\"TESSDATA_PREFIX\"]`" +msgstr "" + +#: ../../functions.rst:71 957507a22c5a4c139993b81293da6741 +msgid ":attr:`pdfcolor`" +msgstr "" + +#: ../../functions.rst:71 07e9d0cd38c34c51883f4da74db66050 +msgid "dictionary of almost 500 RGB colors in PDF format." +msgstr "" + +#: ../../functions.rst:76 5f22a1469d0d4da3a575770af0489a8b +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 "" + +#: ../../functions.rst:78 06b4e06e904b4793a9f1952df5cda09d +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 "" + +#: ../../functions.rst:80 ae26db6af38b4ee29f4d8bcd1068b315 +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 "" + +#: ../../functions.rst 0c5b5bb657ad43ce821aa06fca3aea62 +#: 0f093003961d4672a96036eb016c8f56 1b682b978b854bdfacbe51b63cbe5654 +#: 207594671ed246eaa4552e73f1b3f862 25a95cae3fd84a28b9af64b3c0f5276d +#: 319f74723f0f428ba1afe21a307afdb3 37d5ee76d8d74bfabe4f46e3576fefec +#: 4d446e60a83849f79362ad7ce821bb38 592510be164d45dabecf5dec807b1738 +#: 5afbc867005f472a98f048169c4a077e 5ba9c3ec850f4c2ebc69a011122c424d +#: 6310b1fc7e314965a2cb12ba1de94815 633677978ef24a90bf10c6359238ac81 +#: 642ec7ced6754e688cd8aadb40483e16 6d96da1c0d9b46deb8c1ad3311c7d8f7 +#: 7f8a798a53454f04998940980a6f8f7d 905d4b4141194e34a7b5a4cd5489c174 +#: b02bc5da96434caaa6b56000fcaed0ef b828c5ce05bf42cdabd64a151065f7c8 +#: ba3c85114a754f4292a40b0e7d4422c6 c0f3090df1b84ca2b3e7d828b67d454c +#: c57a36f38b0e4c57ba0841d040262fe4 dd5c75652c8f4613b4f59bcf14b8d564 +msgid "Parameters" +msgstr "" + +#: ../../functions.rst:82 e37dc7be11dd4357ac8edff7736891b4 +msgid "" +"any format name from above in upper or lower case, like *\"A4\"* or " +"*\"letter-l\"*." +msgstr "" + +#: ../../functions.rst 007a4be9e098415dbadbbbdcb355b4b9 +#: 053da18aecba45a089eccb275356a9a6 05a997002367401785b8c1af2d278c83 +#: 13efe1237449448aaeab3e6f52d9f670 1c935f0e87474dbea88d7bdfe736062a +#: 1f8600c03eb740aa861698300d9b7366 46926580e6d141e39793f4b5f15e4bbf +#: 60e0d2472d6a4e3a9e57c656b3113a78 7313801987bc489eae3e8fa52c27cd35 +#: 7927caca0a1e45f2a0a990f6191d549b 8a9dcff4357242579ea370528ff6744e +#: 9640ec6ac02b4dc0b6ccc05d9003bfc8 99a4e53cf35a487bb24d274958d988d0 +#: 9b6dc96e19974c4fb88f867cb735db05 9e9bca8408ad40b7bfba0facdc5cc765 +#: a13e904e915141cdaa29017d938a809c a7bdac8baf774087a0603efbdb0c58dc +#: b7b5a7fd2d494bb8b8d40d9c1354bf64 c30a0a25bcc4471ea107954138ba4402 +#: c3e24fc817104a7f9b356887193d6c76 cda7e136e7f6433b9a0d17594c3a8726 +#: da21eb8cf6c043ea865057ca8cf10793 dbecf93c72624369be0b30526e9b60c4 +#: fd0d288494c74827ab9f71fa7a1b5c28 +msgid "Return type" +msgstr "" + +#: ../../functions.rst 00acf25d4db948a28badb4b34a3a20d7 +#: 03acc96759fe469a8942abde5def6a1b 040e219bfd524ae5863c9fb2c61c0473 +#: 17f6d350e01842939be91958fc3898f3 18b8b004446e4327b3742ef33e70276f +#: 1b9dfbac46724000a32873b923fb9baf 250231ecf37f4eeaa64ea3a5b42ec3fd +#: 25c2c389137643129d643b6316fe593a 3578fac20dc24c8cb173ce46b2b69c21 +#: 3c92dd5274bf45fd9d0f510d57a3162b 3ccfb20eeb3342e7af089fc4fbec8b9a +#: 4519099b619c4720a0a1dab5acdef5f5 4577f5f8c445402fa390e8531dd85701 +#: 46b562e01535404cafaf5841ec0f75f1 54e6ed4ed8ff4864aae3ee850622fd89 +#: 6e719e6ec0e848afa6190bff9f33a1c6 9a1632b5f0614e8c8c128de993548a29 +#: aa15e82363d44506a4ecfb9831f8d44a c28b55a9ca2b4717ac12bac1cdf0a0d6 +#: c8f43ee7670448ec9ec05764c4229860 c964f208f0394806834a05acf64b7d59 +#: d3202521e8154376af25b9747f0dc8b4 e5cba64329734df9a04503d163630af0 +#: ea5df47308a84f77b9212f6e4c8305eb f3762060eb334be398011397a915d6fb +#: f3942feec14541f5a1442c08d0fcd154 f50c55361d0345cdbf5a409f80af8da0 +msgid "Returns" +msgstr "" + +#: ../../functions.rst:85 86277f06328e4544854b92f9fbf19d29 +msgid "" +"*(width, height)* of the paper format. For an unknown format *(-1, -1)* " +"is returned. Examples: *fitz.paper_size(\"A4\")* returns *(595, 842)* and" +" *fitz.paper_size(\"letter-l\")* delivers *(792, 612)*." +msgstr "" + +#: ../../functions.rst:91 e54dec59ce6342419bb8cb3c601e3397 +msgid "Convenience function to return a :ref:`Rect` for a known paper format." +msgstr "" + +#: ../../functions.rst:93 b0496f3676b74523b5c82b8eb3c92785 +msgid "any format name supported by :meth:`paper_size`." +msgstr "" + +#: ../../functions.rst:95 24976cb421ec4fdfaf439c647d767649 +msgid ":ref:`Rect`" +msgstr "" + +#: ../../functions.rst:96 2e384f58e2c149a8b29a303afbca1c7a +msgid "*fitz.Rect(0, 0, width, height)* with *width, height=fitz.paper_size(s)*." +msgstr "" + +#: ../../functions.rst:107 ../../functions.rst:119 ../../functions.rst:246 +#: 35e6d0ed082e4f2981dc4a540b35d2d8 8fd41212fffb479b924d08e9114f2285 +#: d99044679e6a48ccab71f97d4f2f8b76 +msgid "*New in v1.17.4*" +msgstr "" + +#: ../../functions.rst:109 48e08e53a6294894977536f7f167ad0e +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 "" + +#: ../../functions.rst:111 ../../functions.rst:123 +#: 828bad9ea30144adbcf5dc2e8225314a 946aed3a3810494aa55bbfd2b18845bb +msgid "" +"an integer of format RRGGBB, where each color component is an integer in " +"range(255)." +msgstr "" + +#: ../../functions.rst:113 077541f803b346b293068a59fa79027d +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 "" + +#: ../../functions.rst:121 45e71227b5d548339f30149a017bf0d8 +msgid "" +"Convenience function returning a color (red, green, blue) for a given " +"*sRGB* color integer." +msgstr "" + +#: ../../functions.rst:125 542575c045fc430a91cd18aec09acbf2 +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 "" + +#: ../../functions.rst:131 ../../functions.rst:146 ../../functions.rst:161 +#: ../../functions.rst:174 62c318b6b09b436b8dd75b86b29fb198 +#: 742657cd5f4f484c89b64915fb13aa80 bea14f0aee2a4190a0117d38db8b043c +#: f1462d0496604d528d1e085652a0b90f +msgid "*New in v1.18.0*" +msgstr "" + +#: ../../functions.rst:133 679016fbe18940a8a218e58d7fed57b7 +msgid "" +"Return the unicode number of a glyph name based on the **Adobe Glyph " +"List**." +msgstr "" + +#: ../../functions.rst:135 206b55478b7a463c8fd5edcf07c59667 +msgid "" +"the name of some glyph. The function is based on the `Adobe Glyph List " +"`_." +msgstr "" + +#: ../../functions.rst:138 ca4f6f3f2bbf4e77a1bd44f3dafaf178 +msgid "the unicode. Invalid *name* entries return `0xfffd (65533)`." +msgstr "" + +#: ../../functions.rst:140 ../../functions.rst:168 ../../functions.rst:181 +#: 3d6f1c16c40a4d5396171ae7c7cedbdc 7c9fe9e469b24c7c8defdeb2ac222e56 +#: 7fda80a7ee514ec68555310bb0c84d4e +msgid "" +"A similar functionality is provided by package `fontTools " +"`_ in its *agl* sub-package." +msgstr "" + +#: ../../functions.rst:148 b205b6776817459aab942a2a550dce56 +msgid "" +"Return the glyph name of a unicode number, based on the **Adobe Glyph " +"List**." +msgstr "" + +#: ../../functions.rst:150 74628e4e53f54c60b9fc6a6c7ef0eb64 +#: f8a3667d2240493d9f7c060dc18311df +msgid "" +"the unicode given by e.g. `ord(\"ß\")`. The function is based on the " +"`Adobe Glyph List `_." +msgstr "" + +#: ../../functions.rst:153 7b4f67def3b84ce7b830b673e20e322b +msgid "" +"the glyph name. E.g. `fitz.unicode_to_glyph_name(ord(\"Ä\"))` returns " +"`'Adieresis'`." +msgstr "" + +#: ../../functions.rst:155 c84cb614350141ef92996c34bd65a5b3 +msgid "" +"A similar functionality is provided by package `fontTools " +"`_: in its *agl* sub-package." +msgstr "" + +#: ../../functions.rst:163 26d19051922e43ffa213c997a7734908 +msgid "Return a list of glyph names defined in the **Adobe Glyph List**." +msgstr "" + +#: ../../functions.rst:166 dfa29ea562bb46a2abd41acc46c0396d +msgid "list of strings." +msgstr "" + +#: ../../functions.rst:176 a556835797944a2c9c4882695a6dbfbb +msgid "" +"Return a list of unicodes for there exists a glyph name in the **Adobe " +"Glyph List**." +msgstr "" + +#: ../../functions.rst:179 0873a4ae4afd48f78ba3b30304c184cc +msgid "list of integers." +msgstr "" + +#: ../../functions.rst:187 94fea4126a934feb8712b467a5abd805 +msgid "*New in v1.21.0*" +msgstr "" + +#: ../../functions.rst:189 0817fbdc710c4e0d94e07395bc800e46 +msgid "**Utility function for use with \"Story\" applications.**" +msgstr "" + +#: ../../functions.rst:191 c86b292aedbf401d8fdf06b8fa65e306 +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 "" + +#: ../../functions.rst:193 f6c0d73d2cea4e6592f3945e8da5ce94 +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 "" + +#: ../../functions.rst:195 455698ab51ab4da286e546c5b360e543 +msgid "For example, font code \"notos\" refers to fonts" +msgstr "" + +#: ../../functions.rst:197 536a048cc4464849ba857165df09bd5c +msgid "\"notos\" - \"Noto Sans Regular\"" +msgstr "" + +#: ../../functions.rst:198 d5707004f03e4e94b037aeeae9b301aa +msgid "\"notosit\" - \"Noto Sans Italic\"" +msgstr "" + +#: ../../functions.rst:199 2e374a2d686b493c9451a2c8ea381aa5 +msgid "\"notosbo\" - \"Noto Sans Bold\"" +msgstr "" + +#: ../../functions.rst:200 3606945bae534f8fb24dd7151ff23112 +msgid "\"notosbi\" - \"Noto Sans Bold Italic\"" +msgstr "" + +#: ../../functions.rst:202 7126d9afd35049d29c6e8cabefaed0b9 +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 "" + +#: ../../functions.rst:204 8b74de037baf47bab8f0b725b7d6491c +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 "" + +#: ../../functions.rst:206 3764531082b3431a935a3ba534f5f02d +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 "" + +#: ../../functions.rst:208 dc0c950d1d6d4329a7c6af517e10b86e +msgid "" +"`CSS = fitz.css_for_pymupdf_font(\"notos\", name=\"sans-serif\", " +"archive=...)`" +msgstr "" + +#: ../../functions.rst:210 be727c722a5f4e28bdbff28633dcaa06 +msgid "Expects and returns the CSS source, with the new CSS definitions appended." +msgstr "" + +#: ../../functions.rst:212 eb00588baec4443bbd35e0f3c242cf89 +msgid "" +"one of the font codes present in package `pymupdf-fonts " +"`_ (usually) representing the " +"regular version of the font family." +msgstr "" + +#: ../../functions.rst:213 99d6d8bcdce24e29a17a2e3afae93e82 +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 "" + +#: ../../functions.rst:214 d997c9e977bf4602902129b5bb36d5b0 +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 "" + +#: ../../functions.rst:215 d40f43d6ab79478196b3a54cec83a66f +msgid "" +"the name under which the \"fontcode\" fonts should be found. If omitted, " +"\"fontcode\" will be used." +msgstr "" + +#: ../../functions.rst:218 0bcb9ea7e3f94551965b8aedea8463a4 +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 `fitz.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 "" + +#: ../../functions.rst:220 ca62c5e1f45c42db94ba9cf90632b2ad +msgid "" +"Here is a complete snippet for using the \"Noto Sans\" font instead of " +"\"Helvetica\"::" +msgstr "" + +#: ../../functions.rst:231 550553d275dc47d0b4a07861e8bc5e9f +msgid "*New in v1.18.9*" +msgstr "" + +#: ../../functions.rst:233 77a65dadb5d64d30a724fcbbd485856c +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 "" + +#: ../../functions.rst:235 e7b2689b046c434a8c270c999ae5512a +msgid "the value `line[\"dir\"]` of the span's line." +msgstr "" + +#: ../../functions.rst:236 daf8986a757e4cec85f10052df4917ef +msgid "the span sub-dictionary." +msgstr "" + +#: ../../functions.rst:238 70c6f968688e47fe9d04e61a4ef1a988 +msgid "the quadrilateral of the span's text." +msgstr "" + +#: ../../functions.rst:248 c40516743d3341d89df74baa1e7b7544 +msgid "" +"Convenience function to split a rectangle into sub-rectangles. 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 "" + +#: ../../functions.rst:250 75d9ae74d6394d2497fa386cd9b303d0 +msgid "the rectangle to split." +msgstr "" + +#: ../../functions.rst:251 fb0dc40e303a44eb94823fe4f6b90932 +msgid "the desired number of columns." +msgstr "" + +#: ../../functions.rst:252 bbcf8fefb88444a19520c702457cbbdb +msgid "the desired number of rows." +msgstr "" + +#: ../../functions.rst:253 5ce75918f0194d5f818ee2bd9ddafd15 +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 = " +"fitz.make_table(rect, cols=4, rows=3)`:" +msgstr "" + +#: ../../functions.rst:263 6322dd3dd2454475b2368736e8b0f5d1 +msgid "New in version 1.16.2)*" +msgstr "" + +#: ../../functions.rst:265 0995070f6c2540719149095657ef7f16 +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 "" + +#: ../../functions.rst:267 0b698dc2df7c49329ef405da4bdac958 +msgid "starting point of the line." +msgstr "" + +#: ../../functions.rst:268 d53403b3738b469f8b2916b7e51c6cfa +msgid "end point of the line." +msgstr "" + +#: ../../functions.rst:270 a6081a8e4f694ebfa10794fdd570ebc5 +msgid ":ref:`Matrix`" +msgstr "" + +#: ../../functions.rst:271 1d1cd0a7c29547a58c4dee39eaba6d3d +msgid "" +"a matrix which combines a rotation and a translation:: >>> p1 = " +"fitz.Point(1, 1) >>> p2 = fitz.Point(4, 5) >>> abs(p2 - p1) # " +"distance of points 5.0 >>> m = fitz.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:271 7f2e317656be4a2b8500d88233976fbd +msgid "a matrix which combines a rotation and a translation::" +msgstr "" + +#: ../../functions.rst:295 0e36bb6dfe864f4fa57bbf6d12fb456c +msgid "" +"A dictionary of pre-defines paper formats. Used as basis for " +":meth:`paper_size`." +msgstr "" + +#: ../../functions.rst:301 e19da0709852417bb2ee88d8b72d4a68 +msgid "New in v1.17.5" +msgstr "" + +#: ../../functions.rst:303 c790bdf41787447c9c3a964aada00688 +msgid "" +"A dictionary of usable fonts from repository `pymupdf-fonts " +"`_. Items are keyed by their " +"reserved fontname and provide information like this::" +msgstr "" + +#: ../../functions.rst:319 89d2ed762a04466f826940d0453bb3cf +msgid "If `pymupdf-fonts` is not installed, the dictionary is empty." +msgstr "" + +#: ../../functions.rst:321 c23ac2930c7d4c078c05112fcdb08cb8 +msgid "" +"The dictionary keys can be used to define a :ref:`Font` via e.g. `font = " +"fitz.Font(\"fimo\")` -- just like you can do it with the builtin fonts " +"\"Helvetica\" and friends." +msgstr "" + +#: ../../functions.rst:327 8284821c22e44a0cb62d0b9077445ccb +msgid "New in v1.19.4" +msgstr "" + +#: ../../functions.rst:329 ba79f731b7f545428b75dbd68e44f2ad +msgid "" +"Copy of `os.environ[\"TESSDATA_PREFIX\"]` for convenient checking whether" +" there is integrated Tesseract OCR support." +msgstr "" + +#: ../../functions.rst:331 740d9e48ebff49c6a72266e368bbd2fa +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 "" + +#: ../../functions.rst:333 876b6c368ea04590817ce8aad3dbc32d +msgid "" +"This variable is now checked before OCR functions are tried. This " +"prevents verbose messages from MuPDF." +msgstr "" + +#: ../../functions.rst:339 922fbaefac4e4c6a82cd46592a7d6222 +msgid "New in v1.19.6" +msgstr "" + +#: ../../functions.rst:341 9b02828797ab4e6281ae10d5e70d1e56 +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 `fitz.pdfcolor.keys()`." +msgstr "" + +#: ../../functions.rst:343 16489ad28d0c44118b4a9e70a97bbcb3 +msgid "Examples:" +msgstr "" + +#: ../../functions.rst:345 ec2877ffecd44d08808f13ff4f7a7fe5 +msgid "`fitz.pdfcolor[\"red\"] = (1.0, 0.0, 0.0)`" +msgstr "" + +#: ../../functions.rst:346 6e1e480b3d86434dafcfaafdaa5644da +msgid "" +"`fitz.pdfcolor[\"skyblue\"] = (0.5294117647058824, 0.807843137254902, " +"0.9215686274509803)`" +msgstr "" + +#: ../../functions.rst:347 f6833eb9d5a84ca6b88078620c77734f +msgid "" +"`fitz.pdfcolor[\"wheat\"] = (0.9607843137254902, 0.8705882352941177, " +"0.7019607843137254)`" +msgstr "" + +#: ../../functions.rst:353 0d9fa28605f94dfb872d72b1d5df02d4 +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 "" + +#: ../../functions.rst:356 eebe7d68371a45d28ecac0eb347e82c9 +msgid "current local PDF timestamp." +msgstr "" + +#: ../../functions.rst:362 710d04052aba4c1290e47f138fa775e8 +msgid "New in version 1.14.7" +msgstr "" + +#: ../../functions.rst:364 cbaa1770fbcd4170af86f2cbf5b9a46d +msgid "" +"Calculate the length of text on output with a given **builtin** font, " +"fontsize and encoding." +msgstr "" + +#: ../../functions.rst:366 41c1c90d30e04f5fb3dbdca10c46d7da +msgid "the text string." +msgstr "" + +#: ../../functions.rst:367 32d48c629b5044d18da1c123be5168ca +msgid "" +"the fontname. 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 "" + +#: ../../functions.rst:368 541ec885930a4a12b07dfa6e8fbe6a8d +msgid "the fontsize." +msgstr "" + +#: ../../functions.rst:369 85a6beacfcf54dcca78663728f04b96b +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 "" + +#: ../../functions.rst:371 1660b490224d4a25ba181dc4ae8705d1 +msgid "" +"the length in points the string will have (e.g. when used in " +":meth:`Page.insert_text`)." +msgstr "" + +#: ../../functions.rst:373 6c0c55a0f4c74423986ea2a3e9dc80a5 +msgid "" +"This function will only do the calculation -- it won't insert font nor " +"text." +msgstr "" + +#: ../../functions.rst:375 a124dc1abbe64ce9aa05cecccc6afdf6 +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 "" + +#: ../../functions.rst:377 d7e42505358549aa936a32a2eb88f409 +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([fitz.get_text_length(c) for c in text]) > " +"fitz.get_text_length(text)*. So either (1) do the same, or (2) use " +"something like *fitz.get_text_length(text + \"'\")* for your calculation." +msgstr "" + +#: ../../functions.rst:383 bdeba1f8a303488e9283cd6ce8ecbadc +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 "" + +#: ../../functions.rst:385 694a125555d548d7a4c6b9964b29a7ab +msgid "the object to convert" +msgstr "" + +#: ../../functions.rst:388 ecd16e7e141c41d7a7123e23639df9f1 +msgid "PDF-compatible string enclosed in either *()* or *<>*." +msgstr "" + +#: ../../functions.rst:394 0da5f5a28c8440f59e051bf5b2a413de +msgid "New in v1.16.7" +msgstr "" + +#: ../../functions.rst:395 6b58f324c6b54c04a57971af2bbfec8a +msgid "" +"Changed in v1.19.5: also return natural image orientation extracted from " +"EXIF data if present." +msgstr "" + +#: ../../functions.rst:396 23de9444991047e5873702d9a1d90451 +msgid "" +"Changed in v1.22.5: always return `None` in error cases instead of an " +"empty dictionary." +msgstr "" + +#: ../../functions.rst:398 61bd6690db5146d69df3407ac02adc09 +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 "" + +#: ../../functions.rst:400 656835e91f4547a380565fcdf5adf6a9 +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 "" + +#: ../../functions.rst:403 351423b5b30648009f82485ffbe18725 +msgid "" +"No exception is ever raised. In case of an error, `None` is returned. " +"Otherwise, there are the following items:: In [2]: " +"fitz.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: `fitz.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:404 dc9904f27cd349e697c4a0460cdfa3de +msgid "" +"No exception is ever raised. In case of an error, `None` is returned. " +"Otherwise, there are the following items::" +msgstr "" + +#: ../../functions.rst:419 ac2fe5443f4741be9d36411b1a5877b7 +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 "" + +#: ../../functions.rst:421 4ea4d52ea2644d12b1eb4c8a01acbd4c +msgid "Undefined" +msgstr "" + +#: ../../functions.rst:422 e9eb01d0c9e2482e91cc4f403e7f7942 +msgid "0 degree ccw rotation. (Exif = 1)" +msgstr "" + +#: ../../functions.rst:423 7f993aedde9140eba9cd2eefb8e79d58 +msgid "90 degree ccw rotation. (Exif = 8)" +msgstr "" + +#: ../../functions.rst:424 40e06a73a4ab497c8f1621fc5b4cd218 +msgid "180 degree ccw rotation. (Exif = 3)" +msgstr "" + +#: ../../functions.rst:425 b24ced84123046a1ae60b8e83b2b29c5 +msgid "270 degree ccw rotation. (Exif = 6)" +msgstr "" + +#: ../../functions.rst:426 88fc5744b2954f1781a835a4e578dce2 +msgid "flip on X. (Exif = 2)" +msgstr "" + +#: ../../functions.rst:427 ea23bda3446c4384b21f37df71d05f3f +msgid "flip on X, then rotate ccw by 90 degrees. (Exif = 5)" +msgstr "" + +#: ../../functions.rst:428 7fdd57ceb7bf4d1090d091eab9e2481f +msgid "flip on X, then rotate ccw by 180 degrees. (Exif = 4)" +msgstr "" + +#: ../../functions.rst:429 978a217bbcd74049aaa28c9bf3503b0c +msgid "flip on X, then rotate ccw by 270 degrees. (Exif = 7)" +msgstr "" + +#: ../../functions.rst:434 8b9337778c8d411dae72e6f546a0899a +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 "" + +#: ../../functions.rst:435 d15a98601d464106baacf6e48da866d5 +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: " +"`fitz.image_profile(doc.xref_stream_raw(xref))`." +msgstr "" + +#: ../../functions.rst:436 ca46cc2494ae4051912cb9ac105a5fb0 +msgid "" +"Images as returned by the image blocks of :meth:`Page.get_text` using " +"\"dict\" or \"rawdict\" options are also supported." +msgstr "" + +#: ../../functions.rst:443 e9159378e58d48c588adbe40e570f8c5 +msgid "" +"Return the header string required to make a valid document out of page " +"text outputs." +msgstr "" + +#: ../../functions.rst:445 ../../functions.rst:457 +#: 506aef3bcb5743b78e4b32e5c6ba5443 fbd116bef1954192baa84d839c63226c +msgid "type of document. Use the same as the output parameter of *get_text()*." +msgstr "" + +#: ../../functions.rst:447 7d6fedeebc4c4e62b320174a8814724c +msgid "optional arbitrary name to use in output types \"json\" and \"xml\"." +msgstr "" + +#: ../../functions.rst:455 27893426c8af47daa6f5706183879173 +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 "" + +#: ../../functions.rst:465 b0bee77461e6412ba9aa4d100abec0f8 +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 "" + +#: ../../functions.rst:471 e15b3719d2cd47c1a455419321df773d +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 "" + +#: ../../functions.rst:474 6a9e32d896fc4859a3f1337c6b16ac2b +msgid ":data:`xref` of PDF file level XML metadata -- or 0 if none exists." +msgstr "" + +#: ../../functions.rst:480 ff6a1ac3f660460d8cc61dfe55c3c14e +msgid "Run a page through a device." +msgstr "" + +#: ../../functions.rst:482 cd04fbc623d74a7aa4fb6d32092b13aa +msgid "Device, obtained from one of the :ref:`Device` constructors." +msgstr "" + +#: ../../functions.rst:485 6777ac8315e148e98cdc7c8922686581 +msgid "" +"Transformation to apply to the page. Set it to :ref:`Identity` if no " +"transformation is desired." +msgstr "" + +#: ../../functions.rst:492 7cb053c9928d41f3b6775e78796f4fec +msgid "New in v1.19.0" +msgstr "" + +#: ../../functions.rst:493 33cc6f37678b4ba191dc58910b93ef1a +msgid "" +"Changed in v1.22.0: optionally also return the OCG name applicable to the" +" boundary box." +msgstr "" + +#: ../../functions.rst:495 d519e1c46b804c6ea8f634353f287009 +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:495 86d60c9c81c94e83b18079f4f4ffbaf0 +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 "" + +#: ../../functions.rst:497 c99c35217921482e9cca6cff6ea99192 +msgid "`\"fill-text\"` -- normal text (painted without character borders)" +msgstr "" + +#: ../../functions.rst:498 68e87e05545e45c18469997474b87c05 +msgid "`\"stroke-text\"` -- text showing character borders only" +msgstr "" + +#: ../../functions.rst:499 fe7218bd6f224e24877e5dbe1e27eb8a +msgid "" +"`\"ignore-text\"` -- text that should not be displayed (e.g. as used by " +"OCR text layers)" +msgstr "" + +#: ../../functions.rst:500 008f11ad6f1647d5bc24bf698657c7d6 +msgid "`\"fill-path\"` -- drawing with fill color (and no border)" +msgstr "" + +#: ../../functions.rst:501 e285615b63e04475913ae5aced40a311 +msgid "`\"stroke-path\"` -- drawing with border (and no fill color)" +msgstr "" + +#: ../../functions.rst:502 dc12912ad15040bb9cd6fcbcfe5facd5 +msgid "`\"fill-image\"` -- displays an image" +msgstr "" + +#: ../../functions.rst:503 600917cb9a8e4f6eb96dccca51f91540 +msgid "`\"fill-shade\"` -- display a shading" +msgstr "" + +#: ../../functions.rst:505 3d7248a26733426a96265e2d48319326 +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 "" + +#: ../../functions.rst:508 36e284677b2047c78e68f8de3b16fa0b +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 "" + +#: ../../functions.rst:515 9a761d0be4ba49a5807046f68da5f653 +msgid "New in v1.18.16" +msgstr "" + +#: ../../functions.rst:516 cefc50fa2c88442d93c99b521eba9045 +msgid "Changed in v1.19.0: added key \"seqno\"." +msgstr "" + +#: ../../functions.rst:517 979cf9e34359417582a0395480105e75 +msgid "" +"Changed in v1.19.1: stroke and fill colors now always are either RGB or " +"GRAY" +msgstr "" + +#: ../../functions.rst:518 ac1c8f242dd44d51af714bc7c58b8fb1 +msgid "" +"Changed in v1.19.3: span and character bboxes are now also correct if " +"`dir != (1, 0)`." +msgstr "" + +#: ../../functions.rst:519 e0cdbaaab88e4efa976818cf2d895def +msgid "Changed in v1.22.0: add new dictionary key \"layer\"." +msgstr "" + +#: ../../functions.rst:522 4fdf20e2040c4240b6da6fc4187db1bd +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 "" + +#: ../../functions.rst:558 acfe32a8b14a410cbbcdad2b1a7f1ee5 +msgid "Details:" +msgstr "" + +#: ../../functions.rst:560 8acc2e44fa3844f1aa5f9e33700f6fce +msgid "" +"Information above tagged with \"(1)\" has the same meaning and value as " +"explained in :ref:`TextPage`." +msgstr "" + +#: ../../functions.rst:562 ff8bd301742c456ba4057e4b08caa349 +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 "" + +#: ../../functions.rst:563 a50efb4173ff4e7c936d914d50275105 +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 "" + +#: ../../functions.rst:565 f0ca9194769940ea899e669d2c7fabf9 +msgid "There are 3 text span types:" +msgstr "" + +#: ../../functions.rst:567 0c4fe8c57c124be396cd81ebcd43dbfb +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 "" + +#: ../../functions.rst:568 a49a6d39b8174ff8bd487d37294afb38 +msgid "" +"1: Stroked text -- equivalent to `1 Tr`, only the character borders are " +"shown." +msgstr "" + +#: ../../functions.rst:569 97412be3d2fd43a1b43a4162f57f2bd4 +msgid "3: Ignored text -- equivalent to `3 Tr` (hidden text)." +msgstr "" + +#: ../../functions.rst:571 af2c28b45f9a41c190c5a468b3561e5e +#, 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 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 "" + +#: ../../functions.rst:572 466e9aba911147fd99df1151f1a717be +msgid "" +"For data compactness, the character's unicode is provided here. Use " +"built-in function `chr()` for the character itself." +msgstr "" + +#: ../../functions.rst:573 05166581484e4f26919914919180d86d +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 "" + +#: ../../functions.rst:574 790d0d09600047d59bc824ab07af17f8 +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 "" + +#: ../../functions.rst:575 d579b0a73e22461e988d7a3aafe9b6ff +msgid "*(New in v1.19.0)* This is the union of all character bboxes." +msgstr "" + +#: ../../functions.rst:576 e54a8337685644af88cf686d62ec7eec +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 "" + +#: ../../functions.rst:577 9c9d7f47a4694bceb243d5a5d9aaa55f +msgid "" +"*(New in v1.22.0)* The name of the Optional Content Group (OCG) if " +"applicable or `None`." +msgstr "" + +#: ../../functions.rst:579 eda0c71982f0497db4b7a3e6b7db2d0e +msgid "" +"Here is a list of similarities and differences of `page.get_texttrace()` " +"compared to `page.get_text(\"rawdict\")`:" +msgstr "" + +#: ../../functions.rst:581 233880daa906485381f0a4ef1d73b942 +msgid "" +"The method is up to **twice as fast,** compared to \"rawdict\" " +"extraction. Depends on the amount of text." +msgstr "" + +#: ../../functions.rst:582 862b6e9fa3f94c17a6ff5aff717d88e3 +msgid "" +"The returned data is very **much smaller in size** -- although it " +"provides more information." +msgstr "" + +#: ../../functions.rst:583 db8fbe112aa54f93be462439bd2c1787 +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 "" + +#: ../../functions.rst:584 9b2a7ac6af494a078988544b9e0243bb +msgid "" +"If MuPDF returns unicode 0xFFFD (65533) for unrecognized characters, you " +"may still be able to deduct desired information from the glyph id." +msgstr "" + +#: ../../functions.rst:585 7b16d2a3aa284d718a63867696f59574 +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 "" + +#: ../../functions.rst:586 9dc07eddeb7e4685ad7ff041361624d0 +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 "" + +#: ../../functions.rst:604 5d3b70b22ab44363aae587ed8f00e71b +msgid "Ligatures are represented like this:" +msgstr "" + +#: ../../functions.rst:588 c3377f43d70d46b0b5f414d17bfcb4a3 +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 "" + +#: ../../functions.rst:593 7d225c68d5c040d8a927e35cacff2e14 +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 "" + +#: ../../functions.rst:594 84bebd6cdf194e49a4bea8a7868a1d9b +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 "" + +#: ../../functions.rst:596 00db955657a24475a2eaf313e49b0853 +msgid "`\"ff\" -> 0xFB00`" +msgstr "" + +#: ../../functions.rst:597 4cf31296f6b848e1b5c2df60610b5bcb +msgid "`\"fi\" -> 0xFB01`" +msgstr "" + +#: ../../functions.rst:598 22b5874d4dd24a849b798dee016a2edb +msgid "`\"fl\" -> 0xFB02`" +msgstr "" + +#: ../../functions.rst:599 226ef3b38cf64e9e93b95e936704b1ca +msgid "`\"ffi\" -> 0xFB03`" +msgstr "" + +#: ../../functions.rst:600 7ec05314f8614ac29883399a5427fed7 +msgid "`\"ffl\" -> 0xFB04`" +msgstr "" + +#: ../../functions.rst:601 be2500da9eb84d24a3b4ace00352b864 +msgid "`\"ft\" -> 0xFB05`" +msgstr "" + +#: ../../functions.rst:602 715e36767c5c4816bd35104d9eee6c72 +msgid "`\"st\" -> 0xFB06`" +msgstr "" + +#: ../../functions.rst:604 61f2eba784d24a809942458b870f78ed +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 "" + +#: ../../functions.rst:606 4821c025b4e34da5a10b584c2f2036ad +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 "" + +#: ../../functions.rst:608 653504c5dd1348a38c8bca7db4bb5ff6 +msgid "" +"**Changed in v1.21.1:** If applicable, the name of the OCG is shown in " +"`\"layer\"`." +msgstr "" + +#: ../../functions.rst:614 29d6a6c78ceb462d9e66d06311ce5fe9 +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 "" + +#: ../../functions.rst:616 0258a6c8e24a42a182f6dc4ef399a40a +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 "" + +#: ../../functions.rst:622 37320c491fe543adab0aa4b681d12a36 +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 "" + +#: ../../functions.rst:630 0507bb3bb7b9437c87ee29a953c84d50 +msgid "" +"Deprecated wrapper for :meth:`TextPage.extractBLOCKS`. Use " +":meth:`Page.get_text` with the \"blocks\" option instead." +msgstr "" + +#: ../../functions.rst:638 f8cb6ca384374980ac3daeb532df994f +msgid "" +"Deprecated wrapper for :meth:`TextPage.extractWORDS`. Use " +":meth:`Page.get_text` with the \"words\" option instead." +msgstr "" + +#: ../../functions.rst:646 4c047a9317404745b0d9eea747d649fb +msgid "Run a page through a list device and return its display list." +msgstr "" + +#: ../../functions.rst:648 6d0b6c0d4bfe42878a369f074f8748d9 +msgid ":ref:`DisplayList`" +msgstr "" + +#: ../../functions.rst:649 304d73eede4645ccbc8ee324a5012e7f +msgid "the display list of the page." +msgstr "" + +#: ../../functions.rst:655 3a169e0d30c340a19b13abdc5d347dec +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 one entry at most. 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 "" + +#: ../../functions.rst:663 e4022a3007a4485598868e89013fa41a +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 "" + +#: ../../functions.rst:669 03c13aae0a474b15ba9b30d8fd09ffd8 +msgid "Changed in v1.17.6" +msgstr "" + +#: ../../functions.rst:671 124c5650ae1947b5823637200ef29f5c +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 "" + +#: ../../functions.rst:673 32b1d0c929f84236a4abf49296cd8fe8 +msgid "" +"Changed in version 1.16.0 Annotations are no longer implicitly cleaned by" +" this method. Use :meth:`Annot.clean_contents` separately." +msgstr "" + +#: ../../functions.rst:675 df625ded7b404e1c9a640448d1a80360 +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 "" + +#: ../../functions.rst:677 3ae911717b7c4aaa9c53198fc8673289 +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 "" + +#: ../../functions.rst:683 8062de59b7d54a73afd7675d14426b75 +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 "" + +#: ../../functions.rst:692 45f112ce61804037ae6818a275de5d19 +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 "" + +#: ../../functions.rst:699 8bf66cd89cc84b90873fda3585103d42 +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 "" + +#: ../../functions.rst:701 108521e678de4c8bb54ebb5b19085c11 +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 "" + +#: ../../functions.rst:703 b3a9b587a9bd489b8a09272c8eefb4a0 +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 "" + +#: ../../functions.rst:706 1b7cb8d8bd24419caf0bd6f990858c22 +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 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 "" + +#: ../../functions.rst:708 96a9c17dac6b40ddb23417b801df0303 +msgid "This function calculates the pixel width of a string called *text*::" +msgstr "" + +#: ../../functions.rst:720 1192e1bbc59e464da9fd5507c5f6beac +msgid "New in version 1.14.14" +msgstr "" + +#: ../../functions.rst:722 2053ef25c0824fe0b4a21909c5a698ae +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 "" + +#: ../../functions.rst:724 30f961adb96548dc92426503a1c0f57b +msgid ":data:`xref` number." +msgstr "" + +#: ../../functions.rst:726 7e35f5724710408f9d16df50d616fe17 +msgid "" +"*True* if the object definition is followed by data wrapped in keyword " +"pair *stream*, *endstream*." +msgstr "" + +#: ../../functions.rst:732 5c78c303d7b347ba90d2ac0edea6935e +msgid "" +"Increase the :data:`xref` by one entry and return that number. This can " +"then be used to insert a new object." +msgstr "" + +#: ../../functions.rst:734 24c26e5797c94c038cb6faed80327e04 +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 "" + +#: ../../functions.rst:741 b7b76b6fdc304a999d4ab0fe2df1f426 +msgid "Return length of :data:`xref` table." +msgstr "" + +#: ../../functions.rst:744 14b04c56d38245d4b285a3b5130a2d17 +msgid "the number of entries in the :data:`xref` table." +msgstr "" + +#: ../../functions.rst:750 6a8eb49cfcff46c38a7ff5845508471d +msgid "" +"Compute the quadrilateral of a text span extracted via options \"dict\" " +"or \"rawdict\" of :meth:`Page.get_text`." +msgstr "" + +#: ../../functions.rst:752 af6043f3d40a4f3f9e995b6a1643e851 +msgid "" +"`line[\"dir\"]` of the owning line. Use `None` for a span from " +":meth:`Page.get_texttrace`." +msgstr "" + +#: ../../functions.rst:753 ../../functions.rst:763 ../../functions.rst:774 +#: 2fa53e5a7d3b44a8808e2c286be0a4ff 3719277d8608436182477bd3ac187962 +#: bc6cc984af7f4160b0998ecbe45c79f5 +msgid "the span." +msgstr "" + +#: ../../functions.rst:754 019d6bff7cfa4a40912fded40a987ba5 +msgid "" +"the :ref:`Quad` of the span, usable for text marker annotations " +"('Highlight', etc.)." +msgstr "" + +#: ../../functions.rst:760 6ecbf703765944ed8d6a0bb5f2501576 +msgid "" +"Compute the quadrilateral of a text character extracted via option " +"\"rawdict\" of :meth:`Page.get_text`." +msgstr "" + +#: ../../functions.rst:762 ../../functions.rst:773 +#: 26615e5f49734e13bd78a51d215f7c6a 63ad1e2b2f9e468bb2e350db717b8106 +msgid "" +"`line[\"dir\"]` of the owning line. Use `None` for a span from " +":meth:`Page.get_texttrace`." +msgstr "" + +#: ../../functions.rst:764 4d4c5770d3474ec8b3c76b2712e14e9f +msgid "the character." +msgstr "" + +#: ../../functions.rst:765 cd328dc8d0be4c248b342549ca371eb7 +msgid "" +"the :ref:`Quad` of the character, usable for text marker annotations " +"('Highlight', etc.)." +msgstr "" + +#: ../../functions.rst:771 582878be947c4d28b6c7ad7496649370 +msgid "" +"Compute the quadrilateral of a subset of characters of a span extracted " +"via option \"rawdict\" of :meth:`Page.get_text`." +msgstr "" + +#: ../../functions.rst:775 151c0141b95a42fcb2a8e7b662e7c6a4 +msgid "" +"the characters to consider. If omitted, identical to :meth:`recoer_span`." +" If given, the selected extraction option must be \"rawdict\"." +msgstr "" + +#: ../../functions.rst:776 579997409bce49559352a3f11c2414b5 +msgid "" +"the :ref:`Quad` of the selected characters, usable for text marker " +"annotations ('Highlight', etc.)." +msgstr "" + +#: ../../functions.rst:782 017f2a185ac34523a5b2a8e17ad1d487 +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 "" + +#: ../../functions.rst:784 3d2022159b8e4696b49d7921816068fb +msgid "the line." +msgstr "" + +#: ../../functions.rst:785 e7ac0b2a95334a9a92f62c16e2614a8d +msgid "" +"a sub-list of `line[\"spans\"]`. If omitted, the full line quad will be " +"returned." +msgstr "" + +#: ../../functions.rst:786 09a12202a80d4520802ab9f2fb8f8ef3 +msgid "" +"the :ref:`Quad` of the selected line spans, usable for text marker " +"annotations ('Highlight', etc.)." +msgstr "" + +#: ../../functions.rst:792 967a74a8ccf246c99eccca3f642791ed +msgid "" +"Return the name of Tesseract's language support folder. Use this function" +" if the environment variable `TESSDATA_PREFIX` has not been set." +msgstr "" + +#: ../../functions.rst:794 aad068f7a118477d8bac9f103495d3e5 +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 "" + +#: ../../functions.rst:794 3f00ca5b601c4ac0b48d3b0f4926a0c7 +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 "" + +#: ../../functions.rst:796 3131fc04911a4c2789263b4ae31e361c +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 "" + +#: ../../functions.rst:806 7de63cabb133406698181f1c835a625a +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 "" + +#: ../../functions.rst:816 cc87afc83ed04df9affaaf33ea5e8bcb +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 "" + +#: ../../footer.rst:-1 33a97c9098094ca4ab3a1331ea5842b7 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/glossary.mo b/docs/locales/ja/LC_MESSAGES/glossary.mo new file mode 100644 index 000000000..8767438f2 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/glossary.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/glossary.po b/docs/locales/ja/LC_MESSAGES/glossary.po new file mode 100644 index 000000000..038c33de9 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/glossary.po @@ -0,0 +1,376 @@ +# 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" + +#: ../../glossary.rst:7 e19f31fe1a1343318ba2195fde4cf473 +msgid "Glossary" +msgstr "用語集" + +#: ../../glossary.rst:11 559ebcfc3a584ee29b53da3adb2bcd7a +msgid "A Python sequence of 6 numbers." +msgstr "6つの数字からなるPythonのシーケンス。" + +#: ../../glossary.rst:15 a764aa3382144299a0e6403cca4782c7 +msgid "A Python sequence of 4 numbers." +msgstr "4つの数字からなるPythonのシーケンス。" + +#: ../../glossary.rst:19 fd3fd3b9ac3c4e4aab74229818267b31 +msgid "A Python sequence of 4 integers." +msgstr "4つの整数からなるPythonのシーケンス。" + +#: ../../glossary.rst:23 396e5d30e34f4da99da27a5201477013 +msgid "A Python sequence of 2 numbers." +msgstr "2つの数字からなるPythonのシーケンス。" + +#: ../../glossary.rst:27 91ae268aee014865994a9fbbc247432a +msgid "A Python sequence of 4 :data:`point_like` items." +msgstr "4つの :data:`point_like` アイテムからなるPythonのシーケンス。" + +#: ../../glossary.rst:31 7e7e41ff6b68497fbaea6a0926c1a571 +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:37 c886e4417d5246afa984847fafd04b47 +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:39 46b64285bfbe4542983ef35a86bed18f +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:40 d013449fe88e4136b688824e1b9bc095 +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:41 187965af7da04cef902ee744f775c55d +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:45 8c465657863242219ad7e4eb6d263c00 +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:50 fac77678829c4900bb6fe73d866f8a9a +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:54 b769fdd49acc4f3096bd05b6105ef88d +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:56 bff2e60a5bf746bcaa06dab4f283730c +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:58 450984c6af1740c89061451bfa486632 +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:62 27e9d54aac8442b3a607020ce04855ab +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:64 5307e714162f441086b60a415ea0263c +msgid "PyMuPDF provides a number of methods to deal with contents of PDF pages:" +msgstr "PyMuPDFは、PDFページのコンテンツに対処するためのいくつかのメソッドを提供しています：" + +#: ../../glossary.rst:66 6bebc7d2da1d406b9223f7a1ccad20b2 +msgid "" +":meth:`Page.read_contents()` -- reads and concatenates all page contents " +"into one `bytes` object." +msgstr ":meth:`Page.read_contents()` – ページのすべてのコンテンツを読み込んで1つのバイトオブジェクトに連結します。" + +#: ../../glossary.rst:67 6d370f100fe4469888fcae21846e90af +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:68 05cacbd9772e4a05af59a23c8ec92bb9 +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:69 45dc7c92a6044cceb4c848b18f005358 +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:73 43e7eb91ddf349a9a28a5a6080f2f7f4 +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:77 81f00399bf23449db9d9bd4a02bded95 +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:79 32b02b2c6e6142a0a235926821c0ac1d +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:98 5934c25880aa441aabc7f68ba90e5ad1 +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:100 4e49b2ebc4e84d28b4921cd1d2515d5a +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:104 f2da80c94c6a4a15b8cff1612cb9665d +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:108 83b04c5507e34a5ca8168c2c9d0baa48 +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:110 058a874a15384ccabc02f48b1fbcc082 +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:112 790ee2dc242545b886f55659551b585f +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:116 3d7683cfd5264a2a899a40e01ed457e9 +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:120 88f9019142c4408f976381366ddb056f +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:131 7db7c44a77f5445da5a37eac3cc06c13 +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:135 4a4fa168219840dbacb59e8cec87b707 +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:139 b0aaa51cb53645a1b9faf7b47c3ce286 +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 *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:143 bbb8c82242d547f3ae9edd391f06113f +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:147 9f2372feee4748c49bab853e337a0a0b +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:152 7f4f160f17b14e5fafc83959ebf74d03 +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:157 a14b68c194f54194bd364b22e1ee2f0d +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:161 c08a6898a74240be9ccdaa3386f0ea57 +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:165 360ef640063b4c8284c80368d2913c1e +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:-1 7db73cbfb26d489a86e4f33044582fc4 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/header.mo b/docs/locales/ja/LC_MESSAGES/header.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/header.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/header.po b/docs/locales/ja/LC_MESSAGES/header.po new file mode 100644 index 000000000..f39441998 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/header.po @@ -0,0 +1,21 @@ +# 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: 2023-08-16 14:20+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" + diff --git a/docs/locales/ja/LC_MESSAGES/identity.mo b/docs/locales/ja/LC_MESSAGES/identity.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/identity.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/identity.po b/docs/locales/ja/LC_MESSAGES/identity.po new file mode 100644 index 000000000..6febcaace --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/identity.po @@ -0,0 +1,48 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../identity.rst:7 731350c4f90143b1ab99d9ed8e733fef +msgid "Identity" +msgstr "" + +#: ../../identity.rst:9 377835523213419e91cacbc487b265ba +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 *fitz.Matrix(1, 0, 0, 1, 0, 0)*." +msgstr "" + +#: ../../identity.rst:11 84a53943990a473188714f3e97e30c9b +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 d57e330a9e19498f93aaf87d32a3d11c +msgid "" +"If you need a **mutable** identity matrix as a starting point, use one of" +" the following statements::" +msgstr "" + +#: ../../footer.rst:-1 bcfcfa3a1a7c4be0a2c41349e995917b +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/index.mo b/docs/locales/ja/LC_MESSAGES/index.mo new file mode 100644 index 000000000..f8df08b65 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/index.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/index.po b/docs/locales/ja/LC_MESSAGES/index.po new file mode 100644 index 000000000..3389bfb30 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/index.po @@ -0,0 +1,78 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../index.rst:23 7db2305455084d1386000e2a8b725ca7 +msgid "About" +msgstr "" + +#: ../../index.rst:30 b1c7f927e24d45609a41b0b24312981f +msgid "User Guide" +msgstr "ユーザーガイド" + +#: ../../index.rst:40 2887066519114f2f9d103b3f03de1be4 +msgid "How to Guide" +msgstr "使用方法ガイド" + +#: ../../index.rst:47 a7668c448dba484dbe9013f76b7c0acf +msgid "API Reference" +msgstr "APIリファレンス" + +#: ../../index.rst:60 9509c4a35566480ea9a9fa0aa9f4ea3c +msgid "Other" +msgstr "その他" + +#: ../../index.rst:7 2fe7865cbe87410786d583a32023ac87 +msgid "Welcome to :title:`PyMuPDF`" +msgstr "PyMuPDFへようこそ" + +#: ../../index.rst:15 9dfe217cbcdc47e8b6a493b02c2041fe +msgid "" +":title:`PyMuPDF` is an enhanced :title:`Python` binding for `MuPDF " +"`_ -- a lightweight :title:`PDF`, :title:`XPS`, and " +":title:`E-book` viewer, renderer, and toolkit, which is maintained and " +"developed by :title:`Artifex Software, Inc`." +msgstr ":title:`PyMuPDF` は、:title:`PDF` （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な :title:`Python` ライブラリです。" + + + +#: ../../index.rst:17 71c9f3b1745d48b5a073714c1da40c90 +msgid "" +":title:`PyMuPDF` is hosted on `GitHub " +"`_ and registered on `PyPI " +"`_." +msgstr ":title:`PyMuPDF` は `GitHub `_ でホストされ、`PyPI `_ に登録されています。" + +#: ../../index.rst:74 3b1b0718e6e64d3eb02cae79ec00a83c +msgid "Find out about PyMuPDF Utilities" +msgstr "PyMuPDF Utilitiesについて詳しく知る" + +#: ../../index.rst:76 99f3b5bce5444e8da240499d724504cc +msgid "" +"The :title:`GitHub` repository `PyMuPDF-Utilities " +"`_ contains a full range of" +" examples, demonstrations and use cases." +msgstr "GitHubリポジトリ `PyMuPDF-Utilities `_ には、さまざまな例、デモンストレーション、およびユースケースが含まれています。" + +#: ../../footer.rst:-1 0ece491e3ee6409d817e918f5d680de2 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/installation.mo b/docs/locales/ja/LC_MESSAGES/installation.mo new file mode 100644 index 000000000..617ae2c90 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/installation.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/installation.po b/docs/locales/ja/LC_MESSAGES/installation.po new file mode 100644 index 000000000..91bdea897 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/installation.po @@ -0,0 +1,403 @@ +# 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" + +#: ../../installation.rst:6 a1184d6664a64633892b0afc01ee791d +msgid "Installation" +msgstr "インストール" + +#: ../../installation.rst:9 a5b50932024b4d2e8df680cbe22e631f +msgid "Requirements" +msgstr "要件" + +#: ../../installation.rst:11 47d2bdead0ed40d08643235d3878d754 +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." +msgstr "以下のすべての例は、Python仮想環境内で実行していると仮定しています。詳細については、こちらを参照してください：https://docs.python.org/3/library/venv.html 。" + +#: ../../installation.rst:14 ../../installation.rst:146 +#: 43b91cc889554c9d9be0887e8afb9acf 5b048769357c4a02938dc0956af505c7 +msgid "For example::" +msgstr "例えば、以下のようになります::" + +#: ../../installation.rst:20 581117e250614dc090df60b667bf19e5 +msgid "PyMuPDF should be installed using pip with::" +msgstr "PyMuPDFをインストールするには、次のようにpipを使用してください::" + +#: ../../installation.rst:25 a51cc32b63da441da98eb0d8200825ef +msgid "" +"This will install from a Python wheel if one is available for your " +"platform." +msgstr "この方法でインストールすると、対象のプラットフォームに対応するPythonのwheelファイルがある場合は、それを使用してインストールされます。" + +#: ../../installation.rst:29 ca30c2f1b81f4ab0a4c66137c3d0ad4a +msgid "Installation when a suitable wheel is not available" +msgstr "適切なwheelファイルが利用できない場合のインストール方法" + +#: ../../installation.rst:31 c29ec1e08c184c568c914fa00dedfc85 +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:34 f662738ec80f4725b0a5ac5bd59d7c0b +msgid "**This requires C/C++ development tools and SWIG to be installed**:" +msgstr "**これには、C/C++開発ツールとSWIGがインストールされている必要があります。**:" + +#: ../../installation.rst:36 6ea90f70f52642e0bdc63c4dcbd52ba9 +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をインストールするにはシステムのパッケージマネージャを使用してください。" + +#: ../../installation.rst:39 ed3eb16635704bfcb6a693d67a1f1b29 +msgid "For example on Debian Linux, do: `sudo apt install swig`" +msgstr "例えば、Debian Linuxの場合は、次のようにしてください： `sudo apt install swig`" + +#: ../../installation.rst:41 745bae7cb1a34d5581df32a2645f67e9 +msgid "On Windows:" +msgstr "Windowsの場合:" + +#: ../../installation.rst:43 7f4f948198cc4dd59f39f6a6161121cf +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:47 aa9b418a051c41c8ab9caaa51ed9b4d2 +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:51 695c984cdd764563839473e7b4fff12b +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" + +#: ../../installation.rst:54 70ad4c60906848b98e5a0ef0bf4e596d +msgid "" +"On MacOS, install MacPorts using the instructions at: " +"https://www.macports.org/install.php" +msgstr "" +"MacOSでMacPortsをインストールする場合は、以下の指示に従ってください：" +"https://www.macports.org/install.php" + +#: ../../installation.rst:57 e8d819515b9c40fc84776c03c98a7322 +msgid "Then install SWIG with: `sudo port install swig`" +msgstr "その後、以下のコマンドを使用してSWIGをインストールしてください： `sudo port install swig`" + +#: ../../installation.rst:58 a387a4a627b041cdba5685ed59e12e86 +msgid "You may also need: `sudo port install swig-python`" +msgstr "以下も必要になるかもしれません： `sudo port install swig-python`" + +#: ../../installation.rst:60 44972de5a9664b00b5fa41bd5487e23e +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に組み込まれています。" + +#: ../../installation.rst:65 c3e3b33350184e2e9ec80cf4093a369a +msgid "Notes" +msgstr "メモ" + +#: ../../installation.rst:67 8c08d32138bd48c398143bb7afc43641 +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以上に対応しています。" + +#: ../../installation.rst:69 d92391a57fe5475eb12c4cbcb78406c2 +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:74 24ec9bad908a40cba12d549c8c50f080 +msgid "" +"PyMuPDF does not support Python versions prior to 3.8. Older wheels can " +"be found in `this `_ repository and on `PyPI " +"`_. 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 `_ でも見つけることができます。 +なお、通常は公式のPythonリリーススケジュールに従っています。公式サポートが終了したPythonバージョンについては、そのバージョンのホイールの生成も終了することに注意してください。" + +#: ../../installation.rst:77 24b3a17651834b5b96be19c6263e76bd +msgid "" +"There are no **mandatory** external dependencies. However, some optional " +"feature are available only if additional components are installed:" +msgstr "必須の外部依存関係はありません。ただし、追加のコンポーネントをインストールした場合にのみ、一部のオプション機能が利用可能です：" + +#: ../../installation.rst:79 e7883f3a351c46499945ff66950d33ec +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:80 d913b13607ac42f2a949b665f3be513a +msgid "" +"`fontTools `_ is required for " +":meth:`Document.subset_fonts`." +msgstr "`fontTools `_ は :meth:`Document.subset_fonts` の実行に必要です。" + +#: ../../installation.rst:81 8dcd78470e614442b3c9a9310e35ee28 +msgid "" +"`pymupdf-fonts `_ is a " +"collection of nice fonts to be used for text output methods." +msgstr "`pymupdf-fonts `_ は、テキスト出力の方法に使用するための素敵なフォントのコレクションです。" + +#: ../../installation.rst:82 9cc61eb655234f818787fed6cb0220e4 +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` フォルダの名前を含める必要があります。以下を参照してください。" + +#: ../../installation.rst:84 79a4be51ea2547f18fff63898aa7d507 +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:88 656428adb0a2411eb5e5d4a16f7f16c9 +msgid "Installation from source without using an sdist" +msgstr "sdistを使用せずにソースからインストールする方法" + +#: ../../installation.rst:90 fa1ac7bdc32a4469b90fb9c3adb00782 +msgid "First get a PyMuPDF source tree:" +msgstr "まず、PyMuPDFのソースツリーを取得します:" + +#: ../../installation.rst:92 6c9f0c5055a34e99b82108c7e6d3d704 +msgid "" +"Clone the git repository at https://github.com/pymupdf/PyMuPDF, for " +"example::" +msgstr "https://github.com/pymupdf/PyMuPDF から git リポジトリをクローンしてください。 +例えば、以下のように実行します：:" + +#: ../../installation.rst:97 620bfe7b12ce49bc90ec479759f7eece +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:100 ../../installation.rst:138 +#: 2cfecf59e8054877854faf669264e696 69792f917fc04d508a81ff61f23a107f +msgid "Install C/C++ development tools and SWIG as described above." +msgstr "上記に記載されたように、C/C++開発ツールとSWIGをインストールしてください。" + +#: ../../installation.rst:102 817b375842c447f6b431c8bec95c931f +msgid "Build and install PyMuPDF::" +msgstr "PyMuPDFをビルドしてインストールしてください::" + +#: ../../installation.rst:106 b7c040c25cce4467b76876c6776241a3 +msgid "" +"This will automatically download a specific hard-coded MuPDF source " +"release, and build it into PyMuPDF." +msgstr "これにより、特定のハードコードされたMuPDFソースリリースが自動的にダウンロードされ、PyMuPDFにビルドされます。" + +#: ../../installation.rst:109 24c126093ce1415cb2fceeef6cff98ac +msgid "" +"When running Python scripts that use PyMuPDF, make sure that the current " +"directory is not the `PyMuPDF/` directory." +msgstr "PyMuPDFを使用するPythonスクリプトを実行する際は、現在のディレクトリが `PyMuPDF/` ディレクトリでないことを確認してください。" + +#: ../../installation.rst:112 44c02960c9264f208f6b928fa03f70a2 +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` をインポートしようとしますが、それはソースファイルのみを含んでいるため、失敗します。" + +#: ../../installation.rst:115 3ee6e98075ec46c58133fb1a24b139c1 +msgid "Building for different Python versions in same PyMuPDF tree:" +msgstr "同じPyMuPDFツリー内で異なるPythonバージョン用にビルドする方法：" + + +#: ../../installation.rst:118 08dc0c1c83ff4577a7565a02e619611f +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` を使用することができます。" + +#: ../../installation.rst:124 628a2505858a4428a47a374722a4edc4 +msgid "Running tests" +msgstr "テストの実行" + +#: ../../installation.rst:126 22a9d049095947e492adab290762ace6 +msgid "" +"Having a PyMuPDF tree available allows one to run PyMuPDF's `pytest` test" +" suite::" +msgstr "PyMuPDFのディレクトリが利用可能な場合、PyMuPDFの `pytest` テストスイートを実行できます。::" + +#: ../../installation.rst:134 987ea85f282a444594dc75fbbc0e3c05 +msgid "Building and testing with git checkouts of PyMuPDF and MuPDF" +msgstr "PyMuPDFとMuPDFのgitチェックアウトを使ってビルドとテストを行う" + +#: ../../installation.rst:136 04f3d820467142028dd04011256306cf +msgid "Things to do:" +msgstr "やるべきこと：" + +#: ../../installation.rst:139 a6d74e91a47f4472bad52575f205cf35 +msgid "Get PyMuPDF." +msgstr "PyMuPDFを取得する。" + +#: ../../installation.rst:140 adb9f2907f634f62960460fe9db4b01f +msgid "Get MuPDF." +msgstr "MuPDFを取得する。" + +#: ../../installation.rst:141 50111f32f55840e3b9b57062c99c9500 +msgid "Create a Python virtual environment." +msgstr "Pythonの仮想環境を作成する。" + +#: ../../installation.rst:142 ea1e0ae6fbd54da69411844cd85be6af +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をビルドする。" + +#: ../../installation.rst:144 7a75f88aff25406cadf8a433bd486d40 +msgid "Run PyMuPDF tests." +msgstr "PyMuPDFのテストを実行する。" + +#: ../../installation.rst:160 6fd86d1d7dca45588539b75e3f79cb3d +msgid "Using a non-default MuPDF" +msgstr "非デフォルトのMuPDFの使用" + +#: ../../installation.rst:162 fd685f63cf3f4a4395a902c98d022558 +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:166 9a94a8afd84c44d4acc0506579134118 +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:170 942a6466e91041109528a1e388bd2005 +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:174 0286bfc50a814d389ab5655f6d61ae2e +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:182 c152555323174b77afcd9f53d173dbf4 +msgid "Enabling Integrated OCR Support" +msgstr "統合OCRサポートの有効化" + +#: ../../installation.rst:184 09fadd55aa814692adf585f0faa9e367 +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:186 a73c61b92207492c9996afa58cd2369a +msgid "" +"PyMuPDF will already contain all the logic to support OCR functions. But " +"it additionally does need Tesseract's language support data, so " +"installation of Tesseract-OCR is still required." +msgstr "PyMuPDFにはすでにOCR機能をサポートするためのロジックが含まれていますが、追加でTesseractの言語サポートデータが必要です。そのため、Tesseract-OCRのインストールが依然として必要です。" + +#: ../../installation.rst:188 495d63b71f6c4200aa138ed5efb7a578 +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\"` という環境変数に保存するか、適用される関数のパラメータとして指定する必要があります。" + +#: ../../installation.rst:190 ec8bda3786944e40b2ec19e3dc31a18c +msgid "So for a working OCR functionality, make sure to complete this checklist:" +msgstr "OCR機能を正常に動作させるために、以下のチェックリストを完了してください：" + +#: ../../installation.rst:192 434ef6e996ff437bb0e1bc964c118c32 +msgid "Install Tesseract." +msgstr "Tesseractをインストールしてください" + +#: ../../installation.rst:196 5216eccc39354c76aed87736d813b398 +msgid "" +"Locate Tesseract's language support folder. Typically you will find it " +"here:" +msgstr "Tesseractの言語サポートフォルダを見つけてください。通常、以下の場所にあります：" + +#: ../../installation.rst:195 e6227792f6da49b49d7aaf82c7a4982b +msgid "Windows: `C:/Program Files/Tesseract-OCR/tessdata`" +msgstr "" + +#: ../../installation.rst:196 c2edd688929c4aa6a920898f71c56c9d +msgid "Unix systems: `/usr/share/tesseract-ocr/4.00/tessdata`" +msgstr "Unixシステム: `/usr/share/tesseract-ocr/4.00/tessdata`" + +#: ../../installation.rst:200 7d144470dade4b118287162f6de5bd6a +msgid "Set the environment variable `TESSDATA_PREFIX`" +msgstr "環境変数 `TESSDATA_PREFIX` を設定してください：" + +#: ../../installation.rst:199 c9da5fa7db1b4cbe864b75ae185e5e42 +msgid "" +"Windows: `setx TESSDATA_PREFIX \"C:/Program Files/Tesseract-" +"OCR/tessdata\"`" +msgstr "" + +#: ../../installation.rst:200 7f4f0d3263274e818c0f299ddb8a6efd +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:202 a45de6e0f1964b67b5e20e01a48e1a91 +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` を操作するだけではうまく動作しません！" + +#: ../../footer.rst:-1 f4cf9fe304c24fd386b7dfed5389c04d +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/intro.mo b/docs/locales/ja/LC_MESSAGES/intro.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/intro.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/intro.po b/docs/locales/ja/LC_MESSAGES/intro.po new file mode 100644 index 000000000..c3c8c7c61 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/intro.po @@ -0,0 +1,191 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../intro.rst:4 d6f7ed5b9eb1423688bb408e67edc3e5 +msgid "Introduction" +msgstr "" + +#: ../../intro.rst:15 4402c90c8d1f4aa282e238a335f88595 +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 df1f06bbde59419494ea2be66e26be88 +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 87b6f70b9fde43a99d2ae677b8ba37a4 +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 e20b921ee6b14e9aa1f5e8fb46bf4691 +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 ad446126458341d49bd3ae895500af77 +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 ea2cff0b6b6740e199bffd62c948fc65 +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 cb756fc866d74b1bb96f2eb51ec2e1bb +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 cf32eca572c04f40862b40f310d8d14d +msgid "" +"PyMuPDF is hosted on `GitHub `_ and " +"registered on `PyPI `_." +msgstr "" + +#: ../../intro.rst:31 df2a5e635bbe46a6ba4981247f7a1e34 +msgid "" +"For MS Windows, Mac OSX and Linux Python wheels are available -- please " +"see the installation chapter." +msgstr "" + +#: ../../intro.rst:33 9a2ceca853f8447cb264d251ddba1940 +msgid "" +"The GitHub repository `PyMuPDF-Utilities `_ contains a full range of examples, demonstrations " +"and use cases." +msgstr "" + +#: ../../intro.rst:36 9f2d310823ff4e4286307b3a383fec2c +msgid "Note on the Name *fitz*" +msgstr "" + +#: ../../intro.rst:37 167a58dba5644e709fe1cb786a5519d8 +msgid "" +"The top level Python import name for this library is **\"fitz\"**. This " +"has historical reasons:" +msgstr "" + +#: ../../intro.rst:39 72d9f03529144556a78a84f96816cee4 +msgid "The original rendering library for MuPDF was called *Libart*." +msgstr "" + +#: ../../intro.rst:41 b2de3d2b7ff74e89be2b7f3e1ec37c6a +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 6f34e70665c74636842d604345852307 +msgid "" +"So PyMuPDF **cannot coexist** with packages named \"fitz\" in the same " +"Python environment." +msgstr "" + +#: ../../intro.rst:46 a2f95cbffed14ab6be5d8465557ed4f5 +msgid "License and Copyright" +msgstr "" + +#: ../../intro.rst:47 fadeb3b178264c6ab2350bc29941938a +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:49 b52efc64fcce4fbb8301655321b50c1b +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:51 874ef768299442a5a05694563a3a5c3d +msgid "Artifex is the exclusive commercial licensing agent for MuPDF." +msgstr "" + +#: ../../intro.rst:53 cea3c378472145838825a846b725c1d5 +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 77a12559cf2a4f40a5333a516263a277 +msgid "" +"This documentation covers **PyMuPDF v1.23.0rc1** features as of " +"**2023-08-10 00:00:01**." +msgstr "" + +#: ../../version.rst:5 0068d42fc8194a15a7f21cb3070d8422 +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 "" + +#: ../../intro.rst:61 6f233c19119d4e2884385c6805c03d35 +msgid "Footnotes" +msgstr "" + +#: ../../intro.rst:62 63b37b79e8f34d69aee3d9702ea84c36 +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:-1 eb7ef3b15dcf44cfb68efa0e57036e01 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/irect.mo b/docs/locales/ja/LC_MESSAGES/irect.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/irect.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/irect.po b/docs/locales/ja/LC_MESSAGES/irect.po new file mode 100644 index 000000000..422f9f0da --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/irect.po @@ -0,0 +1,488 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../irect.rst:7 8a0aaa03b7274bdfbff03ab0ae7a60c2 +msgid "IRect" +msgstr "" + +#: ../../irect.rst:9 2e246e14c17e44d990f853e4606e0674 +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.rst:12 d3a2cfc17c39440aa86fa0219df334f8 +msgid "**Attribute / Method**" +msgstr "" + +#: ../../irect.rst:12 d5befa2894154df6ac4a121039f5fabd +msgid "**Short Description**" +msgstr "" + +#: ../../irect.rst:14 a0c96043430e42fdb73da84b30610b71 +msgid ":meth:`IRect.contains`" +msgstr "" + +#: ../../irect.rst:14 ae1f37f134d3428f9d43e4c5a891b21a +msgid "checks containment of another object" +msgstr "" + +#: ../../irect.rst:15 a45afc729a6b4d9d89b12fe1e37200dd +msgid ":meth:`IRect.get_area`" +msgstr "" + +#: ../../irect.rst:15 fd4f64825cb64399adbbfef27b9da7aa +msgid "calculate rectangle area" +msgstr "" + +#: ../../irect.rst:16 7c540608d40a4acca49e28051050b66f +msgid ":meth:`IRect.intersect`" +msgstr "" + +#: ../../irect.rst:16 b37a87ed54c54aefb4b51b37bab59fda +msgid "common part with another rectangle" +msgstr "" + +#: ../../irect.rst:17 db1e1231257e4470ac40a51c8d26ba06 +msgid ":meth:`IRect.intersects`" +msgstr "" + +#: ../../irect.rst:17 4c6c7dafd0b942e4bc005de1cc9b7f86 +msgid "checks for non-empty intersection" +msgstr "" + +#: ../../irect.rst:18 37fbb6da0cd44bf0b6ab15c55c70060e +msgid ":meth:`IRect.morph`" +msgstr "" + +#: ../../irect.rst:18 7ed8b37d4b2e4b15b5ee53e170ceed07 +msgid "transform with a point and a matrix" +msgstr "" + +#: ../../irect.rst:19 33fe7d8bcd3d4d6390b5ee373de718a0 +msgid ":meth:`IRect.torect`" +msgstr "" + +#: ../../irect.rst:19 926b9e23f3ae4a84991d01bc88bac271 +msgid "matrix that transforms to another rectangle" +msgstr "" + +#: ../../irect.rst:20 78e3649d4b7c41e6b8d75f7fcc648ff1 +msgid ":meth:`IRect.norm`" +msgstr "" + +#: ../../irect.rst:20 63bdacdabfa749ac8aaec4f505394915 +msgid "the Euclidean norm" +msgstr "" + +#: ../../irect.rst:21 9e8fc08601f54843968ca8a9fb4b1e59 +msgid ":meth:`IRect.normalize`" +msgstr "" + +#: ../../irect.rst:21 32d9e95215ce4a2abe2370b99ce7e3e7 +msgid "makes a rectangle finite" +msgstr "" + +#: ../../irect.rst:22 1fffb1dfcc124a5b8d9adc459aff8303 +msgid ":attr:`IRect.bottom_left`" +msgstr "" + +#: ../../irect.rst:22 b1fa8c5f2ca14c448a3b51b0dc0f5940 +msgid "bottom left point, synonym *bl*" +msgstr "" + +#: ../../irect.rst:23 ecfa4b421510479cb72200f89bbda268 +msgid ":attr:`IRect.bottom_right`" +msgstr "" + +#: ../../irect.rst:23 7518a4170450434fb47ac21df2640622 +msgid "bottom right point, synonym *br*" +msgstr "" + +#: ../../irect.rst:24 ed5a90b4ea134566a590b5ae9dc19132 +msgid ":attr:`IRect.height`" +msgstr "" + +#: ../../irect.rst:24 c72daf8f47d04332a2901bbc7cfc61c9 +msgid "height of the rectangle" +msgstr "" + +#: ../../irect.rst:25 9148e30d31ef43ee9a5e8c79bcdcf4fc +msgid ":attr:`IRect.is_empty`" +msgstr "" + +#: ../../irect.rst:25 2f329e78032c4bca9c48bb09339a6a31 +msgid "whether rectangle is empty" +msgstr "" + +#: ../../irect.rst:26 4a0c6de41fbc46c8aca354251a7fb34b +msgid ":attr:`IRect.is_infinite`" +msgstr "" + +#: ../../irect.rst:26 d91f6b405a464bd394f3dca727e4629a +msgid "whether rectangle is infinite" +msgstr "" + +#: ../../irect.rst:27 78fc4d9865bf4d90be930025df5f4252 +msgid ":attr:`IRect.rect`" +msgstr "" + +#: ../../irect.rst:27 39fe21503e894af6a30a9c0dd67159bb +msgid "the :ref:`Rect` equivalent" +msgstr "" + +#: ../../irect.rst:28 4ce4aa1d6c4e45da8d6917ad5f2d30b8 +msgid ":attr:`IRect.top_left`" +msgstr "" + +#: ../../irect.rst:28 d695def638aa45188391813cd8925786 +msgid "top left point, synonym *tl*" +msgstr "" + +#: ../../irect.rst:29 959043b0e692459f88a2884471e23094 +msgid ":attr:`IRect.top_right`" +msgstr "" + +#: ../../irect.rst:29 dbca183692ee4b3cae6e033baf4fcbdd +msgid "top_right point, synonym *tr*" +msgstr "" + +#: ../../irect.rst:30 b512a92ac83846a3b314405574514c5a +msgid ":attr:`IRect.quad`" +msgstr "" + +#: ../../irect.rst:30 36f4ab7ef95b400cb716411a44f98cfe +msgid ":ref:`Quad` made from rectangle corners" +msgstr "" + +#: ../../irect.rst:31 d8ceb2d4b1344c128b651a9bd574b6cb +msgid ":attr:`IRect.width`" +msgstr "" + +#: ../../irect.rst:31 34169a893d974a758255c749a16a3f06 +msgid "width of the rectangle" +msgstr "" + +#: ../../irect.rst:32 732c32f2428749abadba2820406d3f54 +msgid ":attr:`IRect.x0`" +msgstr "" + +#: ../../irect.rst:32 45f5f576e7134190990c3038fe461132 +msgid "X-coordinate of the top left corner" +msgstr "" + +#: ../../irect.rst:33 528025e3fa314ad9880c9eb2d72a202d +msgid ":attr:`IRect.x1`" +msgstr "" + +#: ../../irect.rst:33 83f5dea77f8c408c81c4e078f6a7701c +msgid "X-coordinate of the bottom right corner" +msgstr "" + +#: ../../irect.rst:34 bc1c1f72f5af4dbaa99f9e6bc4fd0041 +msgid ":attr:`IRect.y0`" +msgstr "" + +#: ../../irect.rst:34 a48b58d9744847799a12c5697472ba6f +msgid "Y-coordinate of the top left corner" +msgstr "" + +#: ../../irect.rst:35 00cafb515532497895bdb977d7e1de8a +msgid ":attr:`IRect.y1`" +msgstr "" + +#: ../../irect.rst:35 6292b692c57b41938f0b2bfadf273066 +msgid "Y-coordinate of the bottom right corner" +msgstr "" + +#: ../../irect.rst:38 b11a77684cf14f048e4d6ce0ff0c0ca5 +msgid "**Class API**" +msgstr "" + +#: ../../irect.rst:50 91be73a2e23d4c4b8028fc81c3ef528e +msgid "" +"Overloaded constructors. Also see examples below and those for the " +":ref:`Rect` class." +msgstr "" + +#: ../../irect.rst:52 0336c1c15fd74788b54cd0b2b2e71ccb +msgid "If another irect is specified, a **new copy** will be made." +msgstr "" + +#: ../../irect.rst:54 2dbb905963ae4ad493a35bd74ad1e2f9 +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 "" + +#: ../../irect.rst:56 f160a199056e4d0a9870dd2e3f1ea9d7 +msgid "The other parameters mean integer coordinates." +msgstr "" + +#: ../../irect.rst:61 58a39731890f4aecacc275527cf5b34f +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 "" + +#: ../../irect.rst 14374e5ef9a449ed9d300bdc31791806 +#: 46ffa462d7154738b06ec00ed03c5836 4cb6aeb293ae4765be8870e8496bd215 +#: 8bb95a0acf1c44daa59fb3cb0da98291 b490ae46308f491fac7caeb9d4e7d29d +#: e129e020facd42caa7d0b2c6d21cc6df +msgid "Parameters" +msgstr "" + +#: ../../irect.rst:63 244734ff53744c7eafd8960a87e10e26 +msgid "" +"Specify required unit: respective squares of \"px\" (pixels, default), " +"\"in\" (inches), \"cm\" (centimeters), or \"mm\" (millimeters)." +msgstr "" + +#: ../../irect.rst 28c7c6ef721c4472b51ec29a15df4d0a +#: b1e332f69cc848abbc1a0ed932675c40 bbcd8b4d67ec4e09819b6c4fffb9ae96 +#: bc9c890e6c60419898a51c3f4e992791 +msgid "Return type" +msgstr "" + +#: ../../irect.rst:69 c83b9870ceb84d2eaf74dacff9b8e241 +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 "" + +#: ../../irect.rst:71 7e1a1af13bf0411cad6913c4560890c8 +msgid "Second rectangle." +msgstr "" + +#: ../../irect.rst:75 de9f88dc3cfb43b685e0ed93df27e22b +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 "" + +#: ../../irect.rst:77 d748aa8f33e947ca9c376e8e123900e4 +msgid "the object to check." +msgstr "" + +#: ../../irect.rst:84 8840863f665b476da138618a149fd3d0 +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 "" + +#: ../../irect.rst:86 bf9c3033677645f2b910867bedc57da7 +msgid "the rectangle to check." +msgstr "" + +#: ../../irect.rst:92 d16825dd39e347df9c9f65f10278cecc +msgid "New in version 1.19.3" +msgstr "" + +#: ../../irect.rst:94 903a7208effa4b17bd2f58efbdf78c24 +msgid "" +"Compute the matrix which transforms this rectangle to a given one. See " +":meth:`Rect.torect`." +msgstr "" + +#: ../../irect.rst:96 f6acd904cd7d4e70839a4240c2ac27bc +msgid "the target rectangle. Must not be empty or infinite." +msgstr "" + +#: ../../irect.rst:97 d5f6cf021ed044afafda2db974b5d88d +msgid ":ref:`Matrix`" +msgstr "" + +#: ../../irect.rst 1153e30500464c979853a076b8e1df64 +#: 71061baccede475283938f9ff7208d37 +msgid "Returns" +msgstr "" + +#: ../../irect.rst:98 2386aac93d4d4efd92637923ee49ecff +msgid "" +"a matrix `mat` such that `self * mat = rect`. Can for example be used to " +"transform between the page and the pixmap coordinates." +msgstr "" + +#: ../../irect.rst:103 8a852aa18fb34f38a19007be783dd914 +msgid "New in version 1.17.0" +msgstr "" + +#: ../../irect.rst:105 bff225132309480cb58f2a4ec2e254c9 +msgid "Return a new quad after applying a matrix to it using a fixed point." +msgstr "" + +#: ../../irect.rst:107 188df4d4ad62405f8e7900fbcbd546eb +msgid "the fixed point." +msgstr "" + +#: ../../irect.rst:108 d5cd1edfc3ed4979957bd0d4812cec91 +msgid "the matrix." +msgstr "" + +#: ../../irect.rst:109 974415e2d4834cf3969051d1322224b9 +msgid "" +"a new :ref:`Quad`. This a wrapper of the same-named quad method. If " +"infinite, the infinite quad is returned." +msgstr "" + +#: ../../irect.rst:113 8c60bfc082f14d9581f53b30479a7bb2 +msgid "New in version 1.16.0" +msgstr "" + +#: ../../irect.rst:115 4c0e35e9f9504e9cae9bead13fe1d787 +msgid "" +"Return the Euclidean norm of the rectangle treated as a vector of four " +"numbers." +msgstr "" + +#: ../../irect.rst:119 289d8d99b0334965af14fed4c8ce0713 +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 "" + +#: ../../irect.rst:125 4a28e87d286e406689602df4a5c33c98 +msgid "Equals *Point(x0, y0)*." +msgstr "" + +#: ../../irect.rst 014a124873fb422396ff2bf9207501c8 +#: 1a37b549be5e447fb40d235956e53b83 1a3f0611c8b94c8eb74bd6ead3900122 +#: 2a02b23aa11a48cab642d775019128fd 3174566a0ef143769c89b5ab37cf8963 +#: 5f4b39f9e65f4feda731b16b04b3c45e 7a55faf135a84807bbac90e37ddb08f1 +#: 8322b2534ee94d65a6b27bee812efb5d abc5726bd9414bfaa9f0c20d25e0553d +#: b5a82d8533724eb688808a3b69dea242 b800e7dd3adc42faa295f04860e136d5 +#: d138ea996db849d4b2eff6e666298607 db002226727d47f99c53610a533ec9eb +#: e393302970ed43ad856cc682c17955dc +msgid "type" +msgstr "" + +#: ../../irect.rst:127 ../../irect.rst:135 ../../irect.rst:143 +#: ../../irect.rst:151 616deaae7809454197314e6b0721790a +#: 950ce08ca4ef4ceca447f1415a8f7b8c 9f00bd7ae6db4d69bacc14c28a5262e6 +#: c7179074ad9f4bf78c3f04044981e774 +msgid ":ref:`Point`" +msgstr "" + +#: ../../irect.rst:133 436d4d0c70f846b0839fa6d395c78370 +msgid "Equals *Point(x1, y0)*." +msgstr "" + +#: ../../irect.rst:141 cbf2c228981249d285ee5e525ce8360d +msgid "Equals *Point(x0, y1)*." +msgstr "" + +#: ../../irect.rst:149 860d8dfff27e4e3bb7fedeb348fe8a51 +msgid "Equals *Point(x1, y1)*." +msgstr "" + +#: ../../irect.rst:155 7c4fc083458e4716aa164d383ecbcaf0 +msgid "The :ref:`Rect` with the same coordinates as floats." +msgstr "" + +#: ../../irect.rst:157 e436443eafaf4cd9b412872af98e3232 +msgid ":ref:`Rect`" +msgstr "" + +#: ../../irect.rst:161 123518b9842f449f9ae28b88e1e998a8 +msgid "The quadrilateral *Quad(irect.tl, irect.tr, irect.bl, irect.br)*." +msgstr "" + +#: ../../irect.rst:163 9d78be18f4644532b8e6beb41851fac0 +msgid ":ref:`Quad`" +msgstr "" + +#: ../../irect.rst:167 bc792b1e45b64e3692bc0680c6da77d4 +msgid "Contains the width of the bounding box. Equals *abs(x1 - x0)*." +msgstr "" + +#: ../../irect.rst:169 ../../irect.rst:175 ../../irect.rst:181 +#: ../../irect.rst:187 ../../irect.rst:193 ../../irect.rst:199 +#: 12f82f13370247adb9f16f183e378684 2f701ecb7c25447bacb4a0ccc0f23154 +#: 579590adb38e4adbbd48a118080cd9c4 785bf81bd941463cadcb715ea7096652 +#: ab87940ade954732a763dd4ddd99bf32 f09533018414416fa6a6bdcc715fc544 +msgid "int" +msgstr "" + +#: ../../irect.rst:173 8a03b3ef88604477b15552ac6654965e +msgid "Contains the height of the bounding box. Equals *abs(y1 - y0)*." +msgstr "" + +#: ../../irect.rst:179 332dcac077534e1db53c72dc3bd499fc +msgid "X-coordinate of the left corners." +msgstr "" + +#: ../../irect.rst:185 b3dafa5331574c989a1818d8b0a21bfd +msgid "Y-coordinate of the top corners." +msgstr "" + +#: ../../irect.rst:191 3ea6f803b6bd49caa45eee91d6e22e20 +msgid "X-coordinate of the right corners." +msgstr "" + +#: ../../irect.rst:197 8f159b89ee654a0fb648bbd344751955 +msgid "Y-coordinate of the bottom corners." +msgstr "" + +#: ../../irect.rst:203 a76ae28ace954c4eb2576f0068142583 +msgid "*True* if rectangle is infinite, *False* otherwise." +msgstr "" + +#: ../../irect.rst:205 ../../irect.rst:211 b535b8a01f824f709310f650407fe9ad +#: f95c738bc099482aaa1aef51ee8f336b +msgid "bool" +msgstr "" + +#: ../../irect.rst:209 e2b926f111f94c8e8934bc7f08f6fd0d +msgid "*True* if rectangle is empty, *False* otherwise." +msgstr "" + +#: ../../irect.rst:216 035bf7ea338a4406973680d5379ebf0f +msgid "" +"This class adheres to the Python sequence protocol, so components can be " +"accessed via their index, too. Also refer to :ref:`SequenceTypes`." +msgstr "" + +#: ../../irect.rst:217 7f72e03c24454111921d309dc187f24a +msgid "" +"Rectangles can be used with arithmetic operators -- see chapter " +":ref:`Algebra`." +msgstr "" + +#: ../../footer.rst:-1 cfce3bfdacbc4f49901dc82c9f9ebb0d +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/link.mo b/docs/locales/ja/LC_MESSAGES/link.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/link.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/link.po b/docs/locales/ja/LC_MESSAGES/link.po new file mode 100644 index 000000000..22bcbc2d5 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/link.po @@ -0,0 +1,345 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../link.rst:7 f68ff008e90e4b5fb4ddd76f095abe87 +msgid "Link" +msgstr "" + +#: ../../link.rst:8 15589dbac3a94c04914b877e0c51f7ef +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 "" + +#: ../../link.rst:10 f5973170b6eb46229ee5a11049d70b4b +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 d10f2a747a9c4f14b9a0f0a3aa685699 +msgid "**Attribute**" +msgstr "" + +#: ../../link.rst:13 55b05c0e8c3140bfb9f72ef7f2542524 +msgid "**Short Description**" +msgstr "" + +#: ../../link.rst:15 70ae0a19965741c598577a7ac6d886bb +msgid ":meth:`Link.set_border`" +msgstr "" + +#: ../../link.rst:15 5b2c785dbacf49f1b833c30876903e70 +msgid "modify border properties" +msgstr "" + +#: ../../link.rst:16 d635d191584c4dd2b0f79f9338292841 +msgid ":meth:`Link.set_colors`" +msgstr "" + +#: ../../link.rst:16 0f0918813bf1430690164d6cfc5ea515 +msgid "modify color properties" +msgstr "" + +#: ../../link.rst:17 5cbb56fa56094e3381d906014546e7ed +msgid ":meth:`Link.set_flags`" +msgstr "" + +#: ../../link.rst:17 7b12165dec784ad99d0838a47568918f +msgid "modify link flags" +msgstr "" + +#: ../../link.rst:18 9529c2b18409463da5cfd0c9269c9852 +msgid ":attr:`Link.border`" +msgstr "" + +#: ../../link.rst:18 3177eb8905bb4957bb1c3cc4f3af25f0 +msgid "border characteristics" +msgstr "" + +#: ../../link.rst:19 0d689309afd342779937d5cffafcf307 +msgid ":attr:`Link.colors`" +msgstr "" + +#: ../../link.rst:19 84fe2464e6fd4f8eb3e889e5cfc990f8 +msgid "border line color" +msgstr "" + +#: ../../link.rst:20 51e3a566eae442108ba874aef8592469 +msgid ":attr:`Link.dest`" +msgstr "" + +#: ../../link.rst:20 58efc27f13a34152bc7b8e92b7d320ea +msgid "points to destination details" +msgstr "" + +#: ../../link.rst:21 73439f43a0f74cb6bcd09fc8dbe900c4 +msgid ":attr:`Link.is_external`" +msgstr "" + +#: ../../link.rst:21 b0ed0a53701d46ff8dec79158156c437 +msgid "external destination?" +msgstr "" + +#: ../../link.rst:22 e45d5c1fe12e46b3bc49ac49103d2584 +msgid ":attr:`Link.flags`" +msgstr "" + +#: ../../link.rst:22 93659be8901b4a7b941e9efe0fad8e44 +msgid "link annotation flags" +msgstr "" + +#: ../../link.rst:23 8046138ac0464e9db864cb0452f0c046 +msgid ":attr:`Link.next`" +msgstr "" + +#: ../../link.rst:23 b0562f983c2d4290abb7009dfbb48012 +msgid "points to next link" +msgstr "" + +#: ../../link.rst:24 9f125cb033b245b69a58620437672610 +msgid ":attr:`Link.rect`" +msgstr "" + +#: ../../link.rst:24 45c428aafe874f879b47fb72157819b2 +msgid "clickable area in untransformed coordinates." +msgstr "" + +#: ../../link.rst:25 2cfa4aad7a2946efa0d3fc32692f37ce +msgid ":attr:`Link.uri`" +msgstr "" + +#: ../../link.rst:25 2e43731aa5174309931682f37a10bfb4 +msgid "link destination" +msgstr "" + +#: ../../link.rst:26 4ca075da82e24bce9570fe04f2a3f632 +msgid ":attr:`Link.xref`" +msgstr "" + +#: ../../link.rst:26 b53578cc160245939ed2f0cb66534086 +msgid ":data:`xref` number of the entry" +msgstr "" + +#: ../../link.rst:29 8280cd583a094a70aba12b2375a21d69 +msgid "**Class API**" +msgstr "" + +#: ../../link.rst:35 61fc19b04d354dffb914e4b6f546fa16 +msgid "PDF only: Change border width and dashing properties." +msgstr "" + +#: ../../link.rst:37 4178c356723e401c958ab8a83eeef87a +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 "" + +#: ../../link.rst 45998c8bf02749f7895c5239a0455c05 +#: da76e50c09504b538d3adc656e460965 +msgid "Parameters" +msgstr "" + +#: ../../link.rst:39 efb493ccbf184517a37062465519ce16 +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 "" + +#: ../../link.rst:41 ../../link.rst:42 ../../link.rst:43 ../../link.rst:54 +#: 5c440454be9447d0be66be33440e7d21 950bbdad84164173897d29cc84deec8d +#: a020b525392042ea88bf479ce17e3dda d7a714ba87aa4daba5adf3042dc49bca +msgid "see above." +msgstr "" + +#: ../../link.rst:47 b9bcf72b21c7456a9f20ebe907f9a7c1 +msgid "PDF only: Changes the \"stroke\" color." +msgstr "" + +#: ../../link.rst:49 0e455357cc374ecabcbbad90699ee76f +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 "" + +#: ../../link.rst:51 9b322ea926a14b88aca43f912229a529 +msgid "" +"*(Changed in version 1.16.9)* Allow colors to be directly set. These " +"parameters are used if *colors* is not a dictionary." +msgstr "" + +#: ../../link.rst:53 dfcb6d8a715b40e29cc16f858e66d705 +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 "" + +#: ../../link.rst:58 ../../link.rst:65 72a53297156341ccb41f778362640e97 +#: de22afabba2d44b9aa99817ca5944cef +msgid "*New in v1.18.16*" +msgstr "" + +#: ../../link.rst:60 cc5c900e271040dabbde476190040178 +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 "" + +#: ../../link.rst:67 5596a5deae7f445c806481b1a4ae9fc9 +msgid "" +"Return the link annotation flags, an integer (see :attr:`Annot.flags` for" +" details). Zero if not a PDF." +msgstr "" + +#: ../../link.rst:72 762006d9fa994193a9aff789ad13dd88 +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 "" + +#: ../../link.rst 1eb9ec3ea71b459cba0b7a5a55ab96ee +#: 70b7d1855d9e4782be4e136c5ca37e6b +msgid "Return type" +msgstr "" + +#: ../../link.rst:78 6cbd9f657d934beea18f77bcfdbcee11 +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 "" + +#: ../../link.rst:80 7c3444c98bdf4cb2bc795359a6330cc3 +msgid "" +"*width* -- a float indicating the border thickness in points. The value " +"is -1.0 if no width is specified." +msgstr "" + +#: ../../link.rst:82 8bd20dd4c0cf4865bc3501649741d508 +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 "" + +#: ../../link.rst:84 3183b38b4e5b44e5aad7f48604e6288f +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 "" + +#: ../../link.rst:90 5e320ac1c12c40c48bad0808345cd8ae +msgid "The area that can be clicked in untransformed coordinates." +msgstr "" + +#: ../../link.rst 3c6fe74094df41e99223b477ca84c27b +#: 3f1fff1610904e8eb1663f27f5a11322 6304e6185c864e139dc9a9489e6ff43c +#: 8ce4e114ce534792b99c94413e2348e7 90baedd896a247a7a03b8c8404bb5c32 +#: b4ac30b05a8c46f59676bd0ba1249960 +msgid "type" +msgstr "" + +#: ../../link.rst:92 c3580ee5c6b04b7898935d0537cdad1d +msgid ":ref:`Rect`" +msgstr "" + +#: ../../link.rst:96 099857219330403a84eec0f7324108ce +msgid "" +"A bool specifying whether the link target is outside of the current " +"document." +msgstr "" + +#: ../../link.rst:98 45bc10abaf5f47c1a2b1106c7b903353 +msgid "bool" +msgstr "" + +#: ../../link.rst:102 8685c6fdfb91490eb4a07dd6349f53c0 +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 "" + +#: ../../link.rst:104 81d6a43bfd694c5fb88bf7c14bc556ef +msgid "str" +msgstr "" + +#: ../../link.rst:108 949ea395d7e24ec4a9d3c63f0f107673 +msgid "An integer specifying the PDF :data:`xref`. Zero if not a PDF." +msgstr "" + +#: ../../link.rst:110 f67ad50c127d46daa516b70ed7a439c1 +msgid "int" +msgstr "" + +#: ../../link.rst:114 f4b8ff6c3c794330aa25ade5f0bd7a01 +msgid "The next link or *None*." +msgstr "" + +#: ../../link.rst:116 0267a804c2a543d882c3c342b651e4f2 +msgid "*Link*" +msgstr "" + +#: ../../link.rst:120 e0be7ee44b014dffa97faaae7391e697 +msgid "The link destination details object." +msgstr "" + +#: ../../link.rst:122 0b8b93e785724640912dfd6072ce45e2 +msgid ":ref:`linkDest`" +msgstr "" + +#: ../../footer.rst:-1 3860853790044374981b18e58699ae6d +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/linkdest.mo b/docs/locales/ja/LC_MESSAGES/linkdest.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/linkdest.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/linkdest.po b/docs/locales/ja/LC_MESSAGES/linkdest.po new file mode 100644 index 000000000..de72a2b26 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/linkdest.po @@ -0,0 +1,257 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../linkdest.rst:7 95a43ed100584af19b80df35af28c795 +msgid "linkDest" +msgstr "" + +#: ../../linkdest.rst:8 5f9c0fe403cb40658a845e3b8208538d +msgid "" +"Class representing the `dest` property of an outline entry or a link. " +"Describes the destination to which such entries point." +msgstr "" + +#: ../../linkdest.rst:10 fd1c83eaa5104bd990306580301efa79 +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 "" + +#: ../../linkdest.rst:13 b842e6f6d9b04119938a7436a2c24e37 +msgid "**Attribute**" +msgstr "" + +#: ../../linkdest.rst:13 a45f45a6eb4440be80b679abef1b312b +msgid "**Short Description**" +msgstr "" + +#: ../../linkdest.rst:15 0808b7456b854c6bb7f3b479f6af8184 +msgid ":attr:`linkDest.dest`" +msgstr "" + +#: ../../linkdest.rst:15 a53bb7a11bcf426ca5c7e59fc2f0c8ae +msgid "destination" +msgstr "" + +#: ../../linkdest.rst:16 f5adcaef0bcd4fbc9efa6cf471720d52 +msgid ":attr:`linkDest.fileSpec`" +msgstr "" + +#: ../../linkdest.rst:16 72599559da344e7f8bbcf61244ae7b88 +msgid "file specification (path, filename)" +msgstr "" + +#: ../../linkdest.rst:17 fbf45eb18c6b476e8710cffff796b525 +msgid ":attr:`linkDest.flags`" +msgstr "" + +#: ../../linkdest.rst:17 63915e949c634d8eb8b7985da505569b +msgid "descriptive flags" +msgstr "" + +#: ../../linkdest.rst:18 7a38f41650984ada88f196740c60784a +msgid ":attr:`linkDest.isMap`" +msgstr "" + +#: ../../linkdest.rst:18 aeadc7ca2ac64aa98ca953215ccd9c07 +msgid "is this a MAP?" +msgstr "" + +#: ../../linkdest.rst:19 4d2947e387094b24b1931e58a0bd5e09 +msgid ":attr:`linkDest.isUri`" +msgstr "" + +#: ../../linkdest.rst:19 d3618bf976904bc48e9befbda482298d +msgid "is this a URI?" +msgstr "" + +#: ../../linkdest.rst:20 ded879571e764df895bb40c6fe3c53e5 +msgid ":attr:`linkDest.kind`" +msgstr "" + +#: ../../linkdest.rst:20 0620f87f8cd44cf5876bc727a99770fe +msgid "kind of destination" +msgstr "" + +#: ../../linkdest.rst:21 3a855f3b1b1e48fa84665a0c3177f790 +msgid ":attr:`linkDest.lt`" +msgstr "" + +#: ../../linkdest.rst:21 71d09e5bd65643e486a99f38094d60a8 +msgid "top left coordinates" +msgstr "" + +#: ../../linkdest.rst:22 3e6818c05b6a44eba4ae6ee028768ff8 +msgid ":attr:`linkDest.named`" +msgstr "" + +#: ../../linkdest.rst:22 2467629dc31044009e381a122d98dfef +msgid "name if named destination" +msgstr "" + +#: ../../linkdest.rst:23 d0442dafb29f40548f84fac988fe2daf +msgid ":attr:`linkDest.newWindow`" +msgstr "" + +#: ../../linkdest.rst:23 20e40221e21d4ceebd745ab726ad63e1 +msgid "name of new window" +msgstr "" + +#: ../../linkdest.rst:24 8152e3fcc1de41e983db5250b3b66a21 +msgid ":attr:`linkDest.page`" +msgstr "" + +#: ../../linkdest.rst:24 c655b25165b9475f8e27e2fef03f6a2f +msgid "page number" +msgstr "" + +#: ../../linkdest.rst:25 bc40539a920c454994c77399faf027d0 +msgid ":attr:`linkDest.rb`" +msgstr "" + +#: ../../linkdest.rst:25 6c093e3f4fee4930a987f3142272abf3 +msgid "bottom right coordinates" +msgstr "" + +#: ../../linkdest.rst:26 654aa0e49dd04bf9a20c0b506320bada +msgid ":attr:`linkDest.uri`" +msgstr "" + +#: ../../linkdest.rst:26 d894bce1579f4c3fae461e71cdde9189 +msgid "URI" +msgstr "" + +#: ../../linkdest.rst:29 4aa3d018208d4b919bf8b85a64ade50f +msgid "**Class API**" +msgstr "" + +#: ../../linkdest.rst:35 63e2effbad754723920821ff5029b731 +msgid "" +"Target destination name if :attr:`linkDest.kind` is :data:`LINK_GOTOR` " +"and :attr:`linkDest.page` is *-1*." +msgstr "" + +#: ../../linkdest.rst 03bf7e758a5e4af3ba648ed9261dc7d8 +#: 1e2e25d98174422c93db739ec9946550 5262e9e5f0204219b389a28a82396112 +#: 72f5ff0ba87b4a7fb52279fa47a77706 8078998110f34fc390e6ecc98c815808 +#: 8ce685bfa8a4469e8917c82e4c7d0df8 9bbc0484c5e5419c8436f3568f8730b9 +#: b7cedb4a149b4e8dadb53ca24bb433bb d09cbaacddb64611b9a0a715c8792e20 +#: d3cefd7bf8dc47d584e16ec5b24aee83 f6a44b0de05c4b8e8ee1b7519bcda762 +#: fa92461457c64aa7b4d0ec0af61f22d4 +msgid "type" +msgstr "" + +#: ../../linkdest.rst:37 ../../linkdest.rst:43 ../../linkdest.rst:79 +#: ../../linkdest.rst:103 0a1aae9c821a4d36a1ba68f52df35aad +#: 1c8f75b083534a2fbadf404798b96e1a 3a67f4f048604d138891ba094a42832a +#: 8ad99e2452eb4f43a30ae9da8df6d65e +msgid "str" +msgstr "" + +#: ../../linkdest.rst:41 e8f2062c309e4e8fbbaa2b21c89941d7 +msgid "" +"Contains the filename and path this link points to, if " +":attr:`linkDest.kind` is :data:`LINK_GOTOR` or :data:`LINK_LAUNCH`." +msgstr "" + +#: ../../linkdest.rst:47 243137ca435d48e69df94f765dc7618f +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 "" + +#: ../../linkdest.rst:49 ../../linkdest.rst:67 ../../linkdest.rst:91 +#: 3841d03f04c1439eb483fda7c940c2e6 91db57c71a6446e0a4bf8c449b49a549 +#: ecc89d22c9cd4d55b9e4b18d52425dda +msgid "int" +msgstr "" + +#: ../../linkdest.rst:53 5d4050c217be43c8aea5e0f5573802d5 +msgid "" +"This flag specifies whether to track the mouse position when the URI is " +"resolved. Default value: False." +msgstr "" + +#: ../../linkdest.rst:55 ../../linkdest.rst:61 ../../linkdest.rst:85 +#: 4f8eb57d34494e82a7297b17c8f6c0cb 51d96d09e544429c8cf581949bf325f1 +#: 72a8a197829d4dab91d659bed4f84a33 +msgid "bool" +msgstr "" + +#: ../../linkdest.rst:59 20e2b7115ad945f383745d1ee1f1db3a +msgid "" +"Specifies whether this destination is an internet resource (as opposed to" +" e.g. a local file specification in URI format)." +msgstr "" + +#: ../../linkdest.rst:65 4891c2777f784486b2bfc89e5331f789 +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 "" + +#: ../../linkdest.rst:71 16f6d36ccf764c57acdb33e0e44f9d88 +msgid "The top left :ref:`Point` of the destination." +msgstr "" + +#: ../../linkdest.rst:73 ../../linkdest.rst:97 1274903de6ba41b6944a5c2c7de1a3e9 +#: b0648a38b2c14bcdbd4fb4e4fcfa3c51 +msgid ":ref:`Point`" +msgstr "" + +#: ../../linkdest.rst:77 51901cc3205f406186b16b26db65af90 +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 "" + +#: ../../linkdest.rst:83 41b840ab4b8e4bd6853eb0a8c3222194 +msgid "If true, the destination should be launched in a new window." +msgstr "" + +#: ../../linkdest.rst:89 cfd00b157fad4b538a427cf9324bc332 +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 "" + +#: ../../linkdest.rst:95 9161b3de923a408990f8c53080c37eed +msgid "The bottom right :ref:`Point` of this destination." +msgstr "" + +#: ../../linkdest.rst:101 fd18322f042a4e3ca142e65e19125b40 +msgid "The name of the URI this destination points to." +msgstr "" + +#: ../../footer.rst:-1 d44897efc00a4962be0927846f704668 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/lowlevel.mo b/docs/locales/ja/LC_MESSAGES/lowlevel.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/lowlevel.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/lowlevel.po b/docs/locales/ja/LC_MESSAGES/lowlevel.po new file mode 100644 index 000000000..ffe38e00e --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/lowlevel.po @@ -0,0 +1,35 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../lowlevel.rst:5 df4b3077185e4c30b05f4dd582d92a75 +msgid "Low Level Functions and Classes" +msgstr "" + +#: ../../lowlevel.rst:6 c253321ecafc450ab93165d0fd9bfd3d +msgid "" +"Contains a number of functions and classes for the experienced user. To " +"be used for special needs or performance requirements." +msgstr "" + +#: ../../footer.rst:-1 1f8bddb84ffb4f26ad21077e71e1f193 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/matrix.mo b/docs/locales/ja/LC_MESSAGES/matrix.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/matrix.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/matrix.po b/docs/locales/ja/LC_MESSAGES/matrix.po new file mode 100644 index 000000000..1c07b4452 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/matrix.po @@ -0,0 +1,476 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../matrix.rst:7 81f54c25dd934d61aeaaf58823b2819b +msgid "Matrix" +msgstr "" + +#: ../../matrix.rst:9 4165dafa3ed54ef1bf0c395b7e2eec83 +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.rst:12 b3c7614c678c47fdba4319ff10727485 +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 "" + +#: ../../matrix.rst:17 a90faa6eed5b4be3a90bfdc919cc647b +msgid "Please note:" +msgstr "" + +#: ../../matrix.rst:19 efcc65960ef64fe0af22f42b4ec5f098 +msgid "" +"the below methods are just convenience functions -- everything they do, " +"can also be achieved by directly manipulating the six numerical values" +msgstr "" + +#: ../../matrix.rst:20 7d4a4e808fb84c66a1e8cda137b271eb +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 "" + +#: ../../matrix.rst:23 c5268e5a0483478dabd87d07883d7868 +msgid "**Method / Attribute**" +msgstr "" + +#: ../../matrix.rst:23 248cdee011774541a11556bf83b12418 +msgid "**Description**" +msgstr "" + +#: ../../matrix.rst:25 8b18e78d713b418bb45ff4fe899a39af +msgid ":meth:`Matrix.prerotate`" +msgstr "" + +#: ../../matrix.rst:25 13974f0669614902ac8fc345517e7dbf +msgid "perform a rotation" +msgstr "" + +#: ../../matrix.rst:26 ea28017b6a544cc69d2983f151d5e4b9 +msgid ":meth:`Matrix.prescale`" +msgstr "" + +#: ../../matrix.rst:26 9a7c92620db14b878ea3971195af6f9a +msgid "perform a scaling" +msgstr "" + +#: ../../matrix.rst:27 c46837359e134447a24a458bdb6ad677 +msgid ":meth:`Matrix.preshear`" +msgstr "" + +#: ../../matrix.rst:27 5224f05715cd4c699b4ac424cf4d4c67 +msgid "perform a shearing (skewing)" +msgstr "" + +#: ../../matrix.rst:28 b8d36dadbb8a4fa6bf814f8826d2bb43 +msgid ":meth:`Matrix.pretranslate`" +msgstr "" + +#: ../../matrix.rst:28 97b0930a88c94658aff18d15c05da33f +msgid "perform a translation (shifting)" +msgstr "" + +#: ../../matrix.rst:29 e4112127526a4bfeaf7218a58fe9d463 +msgid ":meth:`Matrix.concat`" +msgstr "" + +#: ../../matrix.rst:29 798e9aa60e8d429485c6f0556880552f +msgid "perform a matrix multiplication" +msgstr "" + +#: ../../matrix.rst:30 5cc9b5f576044386ae75b8f14420bc88 +msgid ":meth:`Matrix.invert`" +msgstr "" + +#: ../../matrix.rst:30 708ae2cd935340ab96defe35bf686b7f +msgid "calculate the inverted matrix" +msgstr "" + +#: ../../matrix.rst:31 a311aeca15ef4d23b804b92e0493332f +msgid ":meth:`Matrix.norm`" +msgstr "" + +#: ../../matrix.rst:31 709949f7f5304a7da2a025c7b293f7ac +msgid "the Euclidean norm" +msgstr "" + +#: ../../matrix.rst:32 bf448b9070d84aa49c9344c6f47c9cc1 +msgid ":attr:`Matrix.a`" +msgstr "" + +#: ../../matrix.rst:32 8d3b8d19e532434383f61ca5b050e601 +msgid "zoom factor X direction" +msgstr "" + +#: ../../matrix.rst:33 fb3faaf035874689bb5ff26ed0613278 +msgid ":attr:`Matrix.b`" +msgstr "" + +#: ../../matrix.rst:33 f756d6408db943c18362380289716f87 +msgid "shearing effect Y direction" +msgstr "" + +#: ../../matrix.rst:34 16ebc00a2b094b03aec58c9458110797 +msgid ":attr:`Matrix.c`" +msgstr "" + +#: ../../matrix.rst:34 484253949e6f4a4d9d081b96946f5f33 +msgid "shearing effect X direction" +msgstr "" + +#: ../../matrix.rst:35 439f18035d8b42c98dfb603afb6d37f7 +msgid ":attr:`Matrix.d`" +msgstr "" + +#: ../../matrix.rst:35 7a1417f85f7f45ebb31df55a9d77942b +msgid "zoom factor Y direction" +msgstr "" + +#: ../../matrix.rst:36 7001e7a403384f2db41e5e556eb89efc +msgid ":attr:`Matrix.e`" +msgstr "" + +#: ../../matrix.rst:36 d58b048c922741ff93abf25e7fef6706 +msgid "horizontal shift" +msgstr "" + +#: ../../matrix.rst:37 a282a5e608f746df80f781164ead05d4 +msgid ":attr:`Matrix.f`" +msgstr "" + +#: ../../matrix.rst:37 0b43db4bf03649008b2f9490364c448b +msgid "vertical shift" +msgstr "" + +#: ../../matrix.rst:38 b03cf134882e43eb96c013ae99f5d4e9 +msgid ":attr:`Matrix.is_rectilinear`" +msgstr "" + +#: ../../matrix.rst:38 864f2be860874936949781cb46cb0b18 +msgid "true if rect corners will remain rect corners" +msgstr "" + +#: ../../matrix.rst:41 2c35b32508e042ad92adea884e2c656d +msgid "**Class API**" +msgstr "" + +#: ../../matrix.rst:59 8445ee60792d4ec3b80f561afe415cc1 +msgid "Overloaded constructors." +msgstr "" + +#: ../../matrix.rst:61 10881c2993a84390abb689cc7028acc0 +msgid "" +"Without parameters, the zero matrix *Matrix(0.0, 0.0, 0.0, 0.0, 0.0, " +"0.0)* will be created." +msgstr "" + +#: ../../matrix.rst:63 640e3e9b46e041eb805efb0506199c64 +msgid "" +"*zoom-** and *shear-** specify zoom or shear values (float) and create a " +"zoom or shear matrix, respectively." +msgstr "" + +#: ../../matrix.rst:65 fb1119a5403c437b8633e76596efe15c +msgid "For \"matrix\" a **new copy** of another matrix will be made." +msgstr "" + +#: ../../matrix.rst:67 f9cb551a6e914416948d713809b59e18 +msgid "" +"Float value \"degree\" specifies the creation of a rotation matrix which " +"rotates anti-clockwise." +msgstr "" + +#: ../../matrix.rst:69 d07f9f6415c24226a6a56f18f37d8187 +msgid "" +"A \"sequence\" must be any Python sequence object with exactly 6 float " +"entries (see :ref:`SequenceTypes`)." +msgstr "" + +#: ../../matrix.rst:71 4c7b356fb2bb435894203d7983f612da +msgid "" +"*fitz.Matrix(1, 1)*, *fitz.Matrix(0.0 and *fitz.Matrix(fitz.Identity)* " +"create modifiable versions of the :ref:`Identity` matrix, which looks " +"like *[1, 0, 0, 1, 0, 0]*." +msgstr "" + +#: ../../matrix.rst:75 250ebace938f4949b3d723a815e4ec05 +msgid "New in version 1.16.0" +msgstr "" + +#: ../../matrix.rst:77 63a3090cdf394dcca8baecc531741547 +msgid "Return the Euclidean norm of the matrix as a vector." +msgstr "" + +#: ../../matrix.rst:81 9c1302c4e61b46dc9ff89df61c081539 +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 "" + +#: ../../matrix.rst:83 0619818e559a492d88a212e6c904c8f9 +msgid "*[1, 0, 0, 1, 0, 0] -> [cos(deg), sin(deg), -sin(deg), cos(deg), 0, 0]*." +msgstr "" + +#: ../../matrix.rst 149007bfd1b04686a391b132b7247100 +#: 460f54cf0231499e815f05f4ed215054 bdc0fa856ff14782b537cbafe46dff9f +#: c5681ce4b1b24c3b87adebfacd222a64 c83e44bfc15048baafc27a24dc58a236 +#: fc3d2ebef25f4535bd94faa4b654c59f +msgid "Parameters" +msgstr "" + +#: ../../matrix.rst:85 bea2f733d7894634b9ddde5b57963001 +msgid "" +"The rotation angle in degrees (use conventional notation based on Pi = " +"180 degrees)." +msgstr "" + +#: ../../matrix.rst:89 59b1d7c1163a4919a36534e73e49e158 +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 "" + +#: ../../matrix.rst:91 3a6f02ca487447bda57432f673607b1a +msgid "" +"Zoom factor in X direction. For the effect see description of attribute " +"*a*." +msgstr "" + +#: ../../matrix.rst:93 cf45bde157204398a25e8da3abb245e3 +msgid "" +"Zoom factor in Y direction. For the effect see description of attribute " +"*d*." +msgstr "" + +#: ../../matrix.rst:97 b684961b01c84ac58e67952b99e0c562 +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 "" + +#: ../../matrix.rst:99 a2a15bf920224f409d2c9bbb3626c4b8 +msgid "Shearing effect in X direction. See attribute *c*." +msgstr "" + +#: ../../matrix.rst:101 84219430b75c4db0848e3f7eedf87dc5 +msgid "Shearing effect in Y direction. See attribute *b*." +msgstr "" + +#: ../../matrix.rst:105 41065369561343a1a7bd168397dbbbd7 +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 "" + +#: ../../matrix.rst:107 3f0b4ec7f9b146689b4f9cbfeb5df31d +msgid "Translation effect in X direction. See attribute *e*." +msgstr "" + +#: ../../matrix.rst:109 ee1518b79f93447f9bc367b24a5bc9f1 +msgid "Translation effect in Y direction. See attribute *f*." +msgstr "" + +#: ../../matrix.rst:113 ee225f5428ab4536964b041bbb9f3c4a +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 "" + +#: ../../matrix.rst:115 c24fbfa1ede547afb9bf2b71e9467cd8 +msgid "First (left) matrix." +msgstr "" + +#: ../../matrix.rst:118 a143b14e8347496bab62ff681c546292 +msgid "Second (right) matrix." +msgstr "" + +#: ../../matrix.rst:123 7e071e6378f04c43a974e1e54353864b +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 "" + +#: ../../matrix.rst:125 9e8677ffa69c4097bf73fdd1193f3d45 +msgid "Matrix to be inverted. If not provided, the current matrix will be used." +msgstr "" + +#: ../../matrix.rst deac39777acd474e99c6df72538845b6 +msgid "Return type" +msgstr "" + +#: ../../matrix.rst:132 85759e921be84da1b4df322ceedb016f +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 "" + +#: ../../matrix.rst 2f1d549385004e208220ce473024c2ca +#: 3a7a56a8bb7245eb8e6b54cac7208577 6c4b37875914466dab57879bcaacd03a +#: 92a900cc8f0442b6b793211aa84cf101 969b58cb21d545d694b83ad28f9932b6 +#: af9c8963d566434997c7cb1a996fc7fe d3c347cd78fe42d7a408458f3c6ac378 +msgid "type" +msgstr "" + +#: ../../matrix.rst:134 ../../matrix.rst:140 ../../matrix.rst:146 +#: ../../matrix.rst:152 ../../matrix.rst:158 ../../matrix.rst:164 +#: 5263954468ae4d189c742ba581501a05 5cc956a52f3544b09e667a44994a84a7 +#: 76018fcc5d03445bbdf71e891b3a5ba9 b3e002554f6a4d48b06f89c61cbd7d6e +#: be85664795b64573bbb1a4a880c0f946 c4d4ad0af57240859824ce6407fbf2c0 +msgid "float" +msgstr "" + +#: ../../matrix.rst:138 7da8620a271f49468a4ba5260a6298b8 +msgid "" +"Causes a shearing effect: each `Point(x, y)` will become `Point(x, y - " +"b*x)`. Therefore, horizontal lines will be \"tilt\"." +msgstr "" + +#: ../../matrix.rst:144 2ee46e4765dd4f4fa008050ac04f9624 +msgid "" +"Causes a shearing effect: each `Point(x, y)` will become `Point(x - c*y, " +"y)`. Therefore, vertical lines will be \"tilt\"." +msgstr "" + +#: ../../matrix.rst:150 885ac548ac1c40308362ddf35d7662a5 +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 "" + +#: ../../matrix.rst:156 a55e18ef878743b5800232160acec928 +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 "" + +#: ../../matrix.rst:162 c1416c6a7b7148e3b906f88edba24fdd +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 "" + +#: ../../matrix.rst:168 087d279707644657abee06a67b51b2ca +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 "" + +#: ../../matrix.rst:170 c7fa5104b5fd4890beb39c86203a4e5d +msgid "bool" +msgstr "" + +#: ../../matrix.rst:174 e73a84501c6d4744b595b9f1ad0f43a7 +msgid "" +"This class adheres to the Python sequence protocol, so components can be " +"accessed via their index, too. Also refer to :ref:`SequenceTypes`." +msgstr "" + +#: ../../matrix.rst:175 e291eb456f004d84a04b6cba2c111394 +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 "" + +#: ../../matrix.rst:176 4292e07166924e66a3a99db03750c9b7 +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 35599d42748f4be69ab8b9a8f681f81c +msgid "Examples" +msgstr "" + +#: ../../matrix.rst:181 43b270bf4eb448d2a4b6841232430d70 +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 4fd29c2f63864ad78a9e6f0776d790d6 +msgid "The :ref:`Identity` matrix performs no operation." +msgstr "" + +#: ../../matrix.rst:188 481bb90dc0964e338c42f053103c6d8c +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.rst:193 d8523080cb1f4e80844cc397ea3a8af5 +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 "" + +#: ../../matrix.rst:198 2f646bb4597f4a2986ee03e35d3a76be +msgid "A negative :attr:`Matrix.a` causes a left-right flip." +msgstr "" + +#: ../../matrix.rst:203 ec6066b0fbc94627a8bb02f4306a0912 +msgid "A negative :attr:`Matrix.d` causes an up-down flip." +msgstr "" + +#: ../../matrix.rst:208 1e8c98e80e2a4f15b76366bc398396c0 +msgid "Attribute :attr:`Matrix.b` tilts upwards / downwards along the x-axis." +msgstr "" + +#: ../../matrix.rst:213 53865757b9db491eac903459552e4f66 +msgid "Attribute :attr:`Matrix.c` tilts left / right along the y-axis." +msgstr "" + +#: ../../matrix.rst:218 97819c75633e4935b9232b5a241d5492 +msgid "" +"Matrix `Matrix(beta)` performs counterclockwise rotations for positive " +"angles `beta`." +msgstr "" + +#: ../../footer.rst:-1 3407bf71445c4b3183433a2a60b30aab +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/module.mo b/docs/locales/ja/LC_MESSAGES/module.mo new file mode 100644 index 000000000..0173ac962 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/module.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/module.po b/docs/locales/ja/LC_MESSAGES/module.po new file mode 100644 index 000000000..c6cc154f7 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/module.po @@ -0,0 +1,472 @@ +# 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" + +#: ../../module.rst:7 a31991df0f2340b8b4c99c7f96345f4e +msgid "Module *fitz*" +msgstr "モジュール *fitz*" + +#: ../../module.rst:9 16bd414446b644e9a1803bae39acb9c8 +msgid "New in version 1.16.8" +msgstr "バージョン 1.16.8 で新たに追加されました" + +#: ../../module.rst:11 177333f38c834ca7bbd4d0dccecbe159 +msgid "" +"PyMuPDF can also be used in the command line as a **module** to perform " +"utility functions. This feature should obsolete writing some of the most " +"basic scripts." +msgstr "PyMuPDFは、ユーティリティ機能を実行するために**モジュール** としてコマンドラインで使用することもできます。この機能により、最も基本的なスクリプトの記述が廃止される可能性があります。" + +#: ../../module.rst:13 ea1e1511255d4d17a3dc58fdca06670d +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 90e3fc44a3384b2db448007116019a45 +msgid "Invocation" +msgstr "呼び出し" + +#: ../../module.rst:18 1d952702ea454e33a4a4bfdf46630485 +msgid "Invoke the module like this::" +msgstr "次のようにしてモジュールを呼び出します::" + +#: ../../module.rst:24 a9344c646af9490089c74777bc153add +msgid "General remarks:" +msgstr "一般的な注意事項：" + +#: ../../module.rst:26 098327bb4c044a67a37dcdc12bb5554a +msgid "" +"Request help via `\"-h\"`, resp. command-specific help via `\"command " +"-h\"`." +msgstr "ヘルプを要求するには、`"-h"` 、またはコマンド固有のヘルプを要求するには `"command -h"` を使用します。" + +#: ../../module.rst:27 f471170fca5a448f89685e6daa0a4681 +msgid "Parameters may be abbreviated where this does not introduce ambiguities." +msgstr "曖昧さが生じない場所では、パラメータは省略形で指定できます。" + +#: ../../module.rst:28 eed1042a26184ecca9ed96552f8fd19c +msgid "" +"Several commands support parameters `-pages` and `-xrefs`. They are " +"intended for down-selection. Please note that:" +msgstr "いくつかのコマンドは、 `-pages` と `-xrefs` のパラメータをサポートしています。これらは選択範囲を絞るためのものです。以下に注意してください：" + +#: ../../module.rst:30 d809f72fcfd24680a4a0d48de41ec1ff +msgid "**page numbers** for this utility must be given **1-based**." +msgstr "このユーティリティでは、**ページ番号** は1から始まる必要があります。" + +#: ../../module.rst:31 0d8b3d2e59f14825905b6881cc461026 +msgid "valid :data:`xref` numbers start at 1." +msgstr "有効な :data:`xref` 番号は1から始まります。" + +#: ../../module.rst:32 046416c9f04f43afbb9d5355c49e6307 +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:34 7a09d9e2bb0b451aa6081984477fd2c0 +msgid "How to use the module inside your script::" +msgstr "スクリプト内でモジュールを使用する方法::" + +#: ../../module.rst:43 ae75a1683ca444afa813feb68f2e6b00 +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:52 2e6cca2e379240318aae0ecc28918173 +msgid "Cleaning and Copying" +msgstr "クリーニングとコピー" + +#: ../../module.rst:56 5992c480a1a54949a837f19df8128308 +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:89 2baa9b4ae8974a58841489ed2a28929a +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:91 7b20376923e846258a59ff8389783427 +msgid "Please consult :meth:`Document.save` for the parameter meanings." +msgstr "パラメータの意味については、 :meth:`Document.save` をご参照ください。" + +#: ../../module.rst:95 5326f08177fb460a998d3372956d86b5 +msgid "Extracting Fonts and Images" +msgstr "フォントと画像の抽出" + +#: ../../module.rst:96 bc8a7d3bfe354d888a91b85537f10cad +msgid "Extract fonts or images from selected PDF pages to a desired directory::" +msgstr "選択したPDFページからフォントや画像を指定したディレクトリに抽出します::" + +#: ../../module.rst:116 4e51da62052949108e8fdd92babedd16 +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:118 7b5039ce2ed14b86a7de07924b82b5b0 +msgid "" +"**Font filenames** consist of the fontname and the associated extension. " +"Any spaces in the fontname are replaced with hyphens \"-\"." +msgstr "**フォントのファイル名** は、フォント名と関連する拡張子から構成されます。フォント名にスペースがある場合、ハイフン \"-\" で置き換えられます。" + +#: ../../module.rst:120 c765b0ee302d449a90a315ff7804e732 +msgid "The output directory must already exist." +msgstr "出力ディレクトリはすでに存在している必要があります。" + +#: ../../module.rst:122 ad6faa6055a1463cb5b474cccd1238fe +msgid "" +"Except for output directory creation, this feature is **functionally " +"equivalent** to and obsoletes `this script `_." +msgstr "出力ディレクトリの作成を除いて、この機能は `このスクリプト `_ と機能的に同等であり、これを使うことで廃止できます。" + +#: ../../module.rst:126 2f389ddfa6914e59a2c20a3ab2b63353 +msgid "Joining PDF Documents" +msgstr "PDF文書の結合" + +#: ../../module.rst:127 1607e76ad0a64522ba5f123fa53a324f +msgid "To join several PDF files specify::" +msgstr "複数のPDFファイルを結合するには、次のように指定します::" + +#: ../../module.rst:146 4e8c7baecafa4bc5ba8fabbfd61b3058 +msgid "" +"Each input must be entered as **\"filename,password,pages\"**. Password " +"and pages are optional." +msgstr "各入力は「ファイル名、パスワード、ページ」の形式で入力してください。パスワードとページはオプションです。" + +#: ../../module.rst:147 ce8ff4654ca340c69bf7b84265a4ca00 +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:148 88cac3f0d9684dc9b53d300536ab2acc +msgid "" +"The **\"pages\"** format is the same as explained at the top of this " +"section." +msgstr "「ページ」のフォーマットは、このセクションの先頭で説明したものと同じです。" + +#: ../../module.rst:149 312cf72d271b4187842a2c0d19dba5f3 +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:152 b5407cdfac7440849ddec55d527e196b +msgid "Example: To join the following files" +msgstr "例: 以下のファイルを結合する" + +#: ../../module.rst:154 b019e9ed79f94b1792a89e40ee3c210b +msgid "**file1.pdf:** all pages, back to front, no password" +msgstr "**file1.pdf:** すべてのページ、最前面から最後尾、パスワードなし" + +#: ../../module.rst:155 f9065bf782304e3d92edeb87b0b7529a +msgid "**file2.pdf:** last page, first page, password: \"secret\"" +msgstr "**file2.pdf:** 最後のページ、最前面、パスワード: "secret"" + +#: ../../module.rst:156 2abcac7f685041f29cfe9afb428ad551 +msgid "**file3.pdf:** pages 5 to last, no password" +msgstr "**file3.pdf:** 5ページから最後尾、パスワードなし" + +#: ../../module.rst:158 1b3e1ade4df6431fb978d29d409cf97c +msgid "and store the result as **output.pdf** enter this command:" +msgstr "そして結果を **output.pdf** として保存するには、次のコマンドを入力してください:" + +#: ../../module.rst:160 441867c32fb84fe4a9bbfd1d8355528b +msgid "" +"*python -m fitz join -o output.pdf file1.pdf,,N-1 file2.pdf,secret,N,1 " +"file3.pdf,,5-N*" +msgstr "" + +#: ../../module.rst:164 f6edbdaee81c4972868c27b2c819352b +msgid "Low Level Information" +msgstr "低レベル情報" + +#: ../../module.rst:166 b0bb076d1c234f6daa568de6e38966c8 +msgid "" +"Display PDF internal information. Again, there are similarities to " +"*\"mutool show\"*::" +msgstr "PDFの内部情報を表示します。再度、 *「mutool show」* との類似点があります。" + +#: ../../module.rst:187 f1408d1b793245e8aa1fea77cd0bfe88 +msgid "Examples::" +msgstr "例::" + +#: ../../module.rst:236 d0f6ce673c0443fa92b723ec42f9f15c +msgid "Embedded Files Commands" +msgstr "埋め込みファイルコマンド" + +#: ../../module.rst:238 625cc825c0f04f9bbd45aa2dc092de1f +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:241 42f311ede1544dd5823b07478804169e +msgid "Information" +msgstr "情報" + +#: ../../module.rst:243 fb18cbe44cbd45c588923bbb0a5caa1c +msgid "Show the embedded file names (long or short format)::" +msgstr "埋め込みファイルの名前を表示します（長いフォーマットまたは短いフォーマット）::" + +#: ../../module.rst:259 a1cf8a4691114beb981cb1fbf600a7cc +msgid "Example::" +msgstr "例::" + +#: ../../module.rst:280 5f8421ecaa414f779a0a9573d1ab63ee +msgid "Detailed output would look like this per entry::" +msgstr "詳細な出力は、各エントリごとに以下のようになります::" + +#: ../../module.rst:290 6fc9ba114e0f401e9aea7b81f1471888 +msgid "Extraction" +msgstr "抽出" + +#: ../../module.rst:292 151e66c2ba494933857ae5679a268c54 +msgid "Extract an embedded file like this::" +msgstr "埋め込みファイルを以下のように抽出します::" + +#: ../../module.rst:309 dd0655cb0387404c98422edc0ea4308c +msgid "" +"For details consult :meth:`Document.embfile_get`. Example (refer to " +"previous section)::" +msgstr "詳細については、Document.embfile_get() を参照してください。例（前のセクションを参照）::" + +#: ../../module.rst:315 b8c9708b09574bcfb770b98fa02e5213 +msgid "Deletion" +msgstr "削除" + +#: ../../module.rst:316 d9b5dbeab57c48889bd66612e9ba8fd8 +msgid "Delete an embedded file like this::" +msgstr "以下のようにして埋め込みファイルを削除します::" + +#: ../../module.rst:332 5f59c6f8eaa44762b289e44ae76f6dee +msgid "For details consult :meth:`Document.embfile_del`." +msgstr "詳細については、 :meth:`Document.embfile_del` を参照してください。" + +#: ../../module.rst:335 fd9312df62c7426eb041c1bacce2aaf5 +msgid "Insertion" +msgstr "挿入" + +#: ../../module.rst:336 75671b7de0e9454ab2e0db0f2a8bdb41 +msgid "Add a new embedded file using this command::" +msgstr "このコマンドを使用して新しい埋め込みファイルを追加します::" + +#: ../../module.rst:356 d58da09143774cc29f525c5ec905afea +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:359 9964cebef86242979634d562f73eb5a4 +msgid "Updates" +msgstr "更新" + +#: ../../module.rst:360 3eca2bf8e9b24994925cef98d136dafe +msgid "Update an existing embedded file using this command::" +msgstr "このコマンドを使用して既存の埋め込みファイルを更新します::" + +#: ../../module.rst:385 bb8ecb84398f455b80dba6aadd9b4ea8 +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:389 a8613607f2eb47928cc44898caa83202 +msgid "Copying" +msgstr "コピー" + +#: ../../module.rst:390 8aef80057e8a4dd9b10805242224a8f7 +msgid "Copy embedded files between PDFs::" +msgstr "PDF間で埋め込みファイルをコピーします::" + +#: ../../module.rst:414 72fd179efcec4e96a4f6c1da69698814 +msgid "Text Extraction" +msgstr "テキスト抽出 " + +#: ../../module.rst:415 4dd44995a261461b89a608f23e701720 +msgid "New in v1.18.16" +msgstr "v1.18.16で新登場" + +#: ../../module.rst:417 b1ae04299d504437a44f01c49628053b +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:419 ca10b6cf012e47edb516db0e79095ac9 +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:420 6b90da028e05417e8a3dc5508ac914ed +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:421 6637486a13434b98b1cc487aff024162 +msgid "" +"**Layout** strives to reproduce the original appearance of the input " +"pages. You can expect results like this (produced by the command `python " +"-m fitz gettext -pages 1 demo1.pdf`):" +msgstr "**レイアウト** は、入力ページの元の外観を再現しようとします。次のような結果が期待できます（コマンド `python -m fitz gettext -pages 1 demo1.pdf` によって生成されたもの）：" + +#: ../../module.rst:426 4b46d68de71c460da5e9e96603aa68da +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:430 011ebabec99c49388e89c7a52767f5f3 +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:432 9a29022677b5402492666a3be71cffbd +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 fontsize is too small." +msgstr "「レイアウト」モードでは、水平方向、左から右、上から下のテキストのみがサポートされ、他のテキストは無視されます。また、このモードでは、フォントサイズが小さすぎる場合もテキストが無視されます。" + +#: ../../module.rst:434 14adf66c7ef745719f7f45100f475acc +msgid "" +"\"Simple\" and \"blocks\" mode in contrast output **all text** for any " +"text size or orientation." +msgstr "対照的に、「シンプル」モードと「ブロック」モードでは、テキストのサイズや向きに関係なくすべてのテキストが出力されます。" + +#: ../../module.rst:436 52301e8daa624f019b724f1f917c5bbf +msgid "Command::" +msgstr "コマンド::" + +#: ../../module.rst:464 ac06ebdd7bad4a56bff936c4ff13cd0f +msgid "" +"Command options may be abbreviated as long as no ambiguities are " +"introduced. So the following do the same:" +msgstr "コマンドのオプションは、曖昧さが生じない限り、省略形を使用することができます。したがって、以下のように同じ結果を得ることができます：" + +#: ../../module.rst:466 287bd046696a4bd18eb4e0b513f7ca07 +msgid "" +"`... -output text.txt -noligatures -noformfeed -convert-white -grid 3 " +"-extra-spaces ...`" +msgstr "" + +#: ../../module.rst:467 bca2527dcd5d445d95a371bbaffb938f +msgid "`... -o text.txt -nol -nof -c -g 3 -e ...`" +msgstr "" + +#: ../../module.rst:469 a9ba2abcb32f4e08bb7809ab36235b95 +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:471 d7e2bc54e96a4ec7b33c9c9e2bfd7f91 +msgid "**mode:** (str) select a formatting mode -- default is \"layout\"." +msgstr "**mode:** (str) フォーマットモードを選択します - デフォルトは「レイアウト」です。" + +#: ../../module.rst:472 5330929e0bb8469f8001ec05ccad3824 +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:473 e4450f0e25464593b7b1c33ea8279596 +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:474 0535a2f699104cfe98e7ad0ae25e373f +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:475 d66924fad30d4430876f4524677ca876 +msgid "" +"**noformfeed:** (bool) instead of `hex(12)` (formfeed), write linebreaks" +" `\\n` at end of output pages." +msgstr "**noformfeed:** (bool) `hex(12)` （フォームフィード）の代わりに、出力ページの末尾に ``\\n`` 個の改行を書き込みます。" + +#: ../../module.rst:476 c904fa38a8444bbcbdd9adbad28862bd +msgid "**skip-empty:** (bool) skip pages with no text." +msgstr "**skip-empty:** ((bool) テキストがないページをスキップします。" + +#: ../../module.rst:477 f8d4233f4a6b46fd8866c3193022f0ea +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:478 16fd79f9f9494d8395d82a2907922b17 +msgid "" +"**fontsize:** include text with fontsize larger than this value only " +"(default 3). Only relevant for \"layout\" option." +msgstr "**fontsize:** この値よりも大きなフォントサイズを持つテキストのみを含めます（デフォルト3）。 「レイアウト」オプションにのみ関連します。" + +#: ../../footer.rst:-1 e839d66bcec84cbab6a5de1072ad7bda +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/outline.mo b/docs/locales/ja/LC_MESSAGES/outline.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/outline.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/outline.po b/docs/locales/ja/LC_MESSAGES/outline.po new file mode 100644 index 000000000..5ed9fbac9 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/outline.po @@ -0,0 +1,200 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../outline.rst:7 1e58ff19e11743b4b49f05a37fa5e4e3 +msgid "Outline" +msgstr "" + +#: ../../outline.rst:9 735c5d13f6e5456a873a099b79f4dc08 +msgid "" +"*outline* (or \"bookmark\"), is a property of *Document*. 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 "" + +#: ../../outline.rst:12 fd4fdf034bc246d08eb7d1c7dcf04ee9 +msgid "**Method / Attribute**" +msgstr "" + +#: ../../outline.rst:12 02be3d2e52554d9d875ec535e9630e82 +msgid "**Short Description**" +msgstr "" + +#: ../../outline.rst:14 257a86b7e68c41bcb99a8b34475692f1 +msgid ":attr:`Outline.down`" +msgstr "" + +#: ../../outline.rst:14 ff8f0c46f35a4ffeaae45056163e147d +msgid "next item downwards" +msgstr "" + +#: ../../outline.rst:15 2005d164e83549cc869edc7cafb5c8fa +msgid ":attr:`Outline.next`" +msgstr "" + +#: ../../outline.rst:15 92de6b3527474a3baa8dfe3d1e4ae448 +msgid "next item same level" +msgstr "" + +#: ../../outline.rst:16 d97b8dfa3c324be79bf031ff0138bd5f +msgid ":attr:`Outline.page`" +msgstr "" + +#: ../../outline.rst:16 d7220c5ee3b14e6b9186e42952b53819 +msgid "page number (0-based)" +msgstr "" + +#: ../../outline.rst:17 a6b6535b5e28403b9ad6ca51e203d11a +msgid ":attr:`Outline.title`" +msgstr "" + +#: ../../outline.rst:17 2a21e84cd6fd498f8fb30819396cca34 +msgid "title" +msgstr "" + +#: ../../outline.rst:18 22924a94716d4813bb2a0980ec3d291a +msgid ":attr:`Outline.uri`" +msgstr "" + +#: ../../outline.rst:18 e48fc77c73ba4d248f60a4939ab16f2b +msgid "string further specifying outline target" +msgstr "" + +#: ../../outline.rst:19 208d4ef31a9c406d96627ece9bfe553d +msgid ":attr:`Outline.is_external`" +msgstr "" + +#: ../../outline.rst:19 7513aae057f24d02b0697892e9ac6681 +msgid "target outside document" +msgstr "" + +#: ../../outline.rst:20 7c42624edf414c9c8bcaa441ae8d1cf5 +msgid ":attr:`Outline.is_open`" +msgstr "" + +#: ../../outline.rst:20 a5c68c9a13dd497bbe7f688e4c639cf4 +msgid "whether sub-outlines are open or collapsed" +msgstr "" + +#: ../../outline.rst:21 825f971fef0e488995250d3eddba1839 +msgid ":attr:`Outline.dest`" +msgstr "" + +#: ../../outline.rst:21 5ca85bedd75b4810b7e611d4dd05b453 +msgid "points to destination details object" +msgstr "" + +#: ../../outline.rst:24 21228ba556e64733ac8daf7eced818ec +msgid "**Class API**" +msgstr "" + +#: ../../outline.rst:30 2b1bcf7008644ce1846858f5f8874b1a +msgid "" +"The next outline item on the next level down. Is *None* if the item has " +"no kids." +msgstr "" + +#: ../../outline.rst 265d93ba1ade46bc96a61664ead628db +#: 445a145f8f0d429a9ddb0d6154d0e6be 45f796a54fba4df8a4e8d97b75125d6e +#: 6041f339d0364a52bf71d2338f03b59b 8630525ac8d147b0884a3c4bd85673f5 +#: a988864c89374d7ba6133dca31442be8 acb48cbe26c74a48a24f0c217e7f4d8f +#: d92f3d6f0bd4494cbed1218a97aa0c1e +msgid "type" +msgstr "" + +#: ../../outline.rst:32 8f3edd0cb4c644caab5d3a6770cd716a +msgid ":ref:`Outline`" +msgstr "" + +#: ../../outline.rst:36 8b147830e3714a8da5443557e29285dd +msgid "" +"The next outline item at the same level as this item. Is *None* if this " +"is the last one in its level." +msgstr "" + +#: ../../outline.rst:38 dddef11e55394bef96a39375a4e0a6fd +msgid "`Outline`" +msgstr "" + +#: ../../outline.rst:42 b7aff344071f4b5685e51ba959b46910 +msgid "The page number (0-based) this bookmark points to." +msgstr "" + +#: ../../outline.rst:44 46b7e5afd6f644f5b766a6bbccc75e6a +msgid "int" +msgstr "" + +#: ../../outline.rst:48 d5ef411d81db4b248fbc122c8ee7c0b8 +msgid "The item's title as a string or *None*." +msgstr "" + +#: ../../outline.rst:50 ../../outline.rst:68 c63a6d00a69448c9af74976fbf18b4f1 +#: faff6ee44b22433abb075df6c68d25a1 +msgid "str" +msgstr "" + +#: ../../outline.rst:54 73917ac42dfe453bb5f3ec820979a2c0 +msgid "" +"Indicator showing whether any sub-outlines should be expanded (*True*) or" +" be collapsed (*False*). This information is interpreted by PDF reader " +"software." +msgstr "" + +#: ../../outline.rst:56 ../../outline.rst:62 139f7170776e4538ba46b4bfd43a3fea +#: 91b2f2f17b094edebf143cdae26a05fa +msgid "bool" +msgstr "" + +#: ../../outline.rst:60 f7d96da15c3c40939205e54e5787e196 +msgid "" +"A bool specifying whether the target is outside (*True*) of the current " +"document." +msgstr "" + +#: ../../outline.rst:66 dea3eeb0f3b6436b92398c33be4378cc +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 "" + +#: ../../outline.rst:72 7f0c9f2b66b344c894f6655f89104a40 +msgid "The link destination details object." +msgstr "" + +#: ../../outline.rst:74 e475b45603554099a59fca9e289946a5 +msgid ":ref:`linkDest`" +msgstr "" + +#: ../../footer.rst:-1 3eceab87b9da4869b2bce38214a4acfb +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/page.mo b/docs/locales/ja/LC_MESSAGES/page.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/page.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/page.po b/docs/locales/ja/LC_MESSAGES/page.po new file mode 100644 index 000000000..684f6457d --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/page.po @@ -0,0 +1,4616 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../page.rst:7 867a43a892774ec39232a5bb8b972553 +msgid "Page" +msgstr "" + +#: ../../page.rst:9 8ecacd3db4894287a0b871441e71111f +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 "" + +#: ../../page.rst:11 9e5203daff0d4a01885ff1d6f30d33e1 +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 75bf2f5f23794e8c9bde12eabc0534d6 +msgid "" +"Several page methods have a :ref:`Document` counterpart for convenience. " +"At the end of this chapter you will find a synopsis." +msgstr "" + +#: ../../page.rst:16 339ac03266044f11bfa5332b97d71cab +msgid "Modifying Pages" +msgstr "" + +#: ../../page.rst:17 a3b8a6c7811e401daa02e230a98081a6 +msgid "" +"Changing page properties and adding or changing page content is available" +" for PDF documents only." +msgstr "" + +#: ../../page.rst:19 d968fbfa08c94193997a92ee6139cbef +msgid "In a nutshell, this is what you can do with PyMuPDF:" +msgstr "" + +#: ../../page.rst:21 f363f2b602004f8cbe44662393bf087c +msgid "Modify page rotation and the visible part (\"cropbox\") of the page." +msgstr "" + +#: ../../page.rst:22 43d6148cea344f84b6baa899ae0acf87 +msgid "Insert images, other PDF pages, text and simple geometrical objects." +msgstr "" + +#: ../../page.rst:23 f8972c9aaa0a431ebd54b9a0a4f38638 +msgid "Add annotations and form fields." +msgstr "" + +#: ../../page.rst:27 ea749ad8b36848e18a33e7fe4e5c4cd5 +msgid "" +"Methods require coordinates (points, rectangles) to put content in " +"desired places. Please be aware that since v1.17.0 these coordinates " +"**must always** be provided relative to the **unrotated** page. 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 "" + +#: ../../page.rst:29 ca3280bda62845d0bfcb9bc13451a070 +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 "" + +#: ../../page.rst:33 95146bbbd4ac4ae3acc1c19b4c2b8fb6 +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 "" + +#: ../../page.rst:35 7c2f9d2bc28c453eb5628e5bf8e3a0c2 +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 "" + +#: ../../page.rst:37 1313f7e5184a4c95a94d56389e32496f +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 "" + +#: ../../page.rst:40 6ef10918094a4e05945872b75ee14e27 +msgid "**Method / Attribute**" +msgstr "" + +#: ../../page.rst:40 fd2a92a98b53401d8ad719c72c4af334 +msgid "**Short Description**" +msgstr "" + +#: ../../page.rst:42 a70d68eaa17e421fa19038f1203102c1 +msgid ":meth:`Page.add_caret_annot`" +msgstr "" + +#: ../../page.rst:42 6e6364896a11499ebae10333ef1e399e +msgid "PDF only: add a caret annotation" +msgstr "" + +#: ../../page.rst:43 9d5f8ca5ce28400cac6edbdb16e580f2 +msgid ":meth:`Page.add_circle_annot`" +msgstr "" + +#: ../../page.rst:43 6940d53f4d784e34ac379dca39f98ba9 +msgid "PDF only: add a circle annotation" +msgstr "" + +#: ../../page.rst:44 0f9628a2f0404760aabf820fdfac40e0 +msgid ":meth:`Page.add_file_annot`" +msgstr "" + +#: ../../page.rst:44 c5808deb24b54e708863772df829e35d +msgid "PDF only: add a file attachment annotation" +msgstr "" + +#: ../../page.rst:45 5b34427878d44ffd84309578d8dcf698 +msgid ":meth:`Page.add_freetext_annot`" +msgstr "" + +#: ../../page.rst:45 c2f015e07f4a4866aad4e4c12f73664a +msgid "PDF only: add a text annotation" +msgstr "" + +#: ../../page.rst:46 84f655a94fd9404f885c28206aeaf8b3 +msgid ":meth:`Page.add_highlight_annot`" +msgstr "" + +#: ../../page.rst:46 c8f5a0747f9a40faab89d7913a97e967 +msgid "PDF only: add a \"highlight\" annotation" +msgstr "" + +#: ../../page.rst:47 2d521aadcb1b406b8d9c5d771c244eda +msgid ":meth:`Page.add_ink_annot`" +msgstr "" + +#: ../../page.rst:47 b9047916e22a4406b7b472836782fc1f +msgid "PDF only: add an ink annotation" +msgstr "" + +#: ../../page.rst:48 8c048b6c73244fc5b6dbb8e953144e1b +msgid ":meth:`Page.add_line_annot`" +msgstr "" + +#: ../../page.rst:48 cb1aeae7f2cb4eb0aa1b2f6ab09a8c98 +msgid "PDF only: add a line annotation" +msgstr "" + +#: ../../page.rst:49 0a3b61a30287449f9149fb8781584591 +msgid ":meth:`Page.add_polygon_annot`" +msgstr "" + +#: ../../page.rst:49 3ceb12bd2dd0419ab4a598664975bbbe +msgid "PDF only: add a polygon annotation" +msgstr "" + +#: ../../page.rst:50 30762559813c475695211805dcd945f9 +msgid ":meth:`Page.add_polyline_annot`" +msgstr "" + +#: ../../page.rst:50 26675dc619e44dbca8d3cd0bb8880ee2 +msgid "PDF only: add a multi-line annotation" +msgstr "" + +#: ../../page.rst:51 63dd8ce3e0f04e83929393d9f1929c36 +msgid ":meth:`Page.add_rect_annot`" +msgstr "" + +#: ../../page.rst:51 b6777529256b4476b56de3f6605e75a1 +msgid "PDF only: add a rectangle annotation" +msgstr "" + +#: ../../page.rst:52 c5ac64aae0db41c3a03a7f00d2d938e3 +msgid ":meth:`Page.add_redact_annot`" +msgstr "" + +#: ../../page.rst:52 92e62e41ec1d48c995dfee9c08b38e74 +msgid "PDF only: add a redaction annotation" +msgstr "" + +#: ../../page.rst:53 caa4c7783e7c4927b7c23da1f307f64e +msgid ":meth:`Page.add_squiggly_annot`" +msgstr "" + +#: ../../page.rst:53 332691a6d3bf452694cf54fe49ac2cf5 +msgid "PDF only: add a \"squiggly\" annotation" +msgstr "" + +#: ../../page.rst:54 bae01b677c354234abc341a8a198eb58 +msgid ":meth:`Page.add_stamp_annot`" +msgstr "" + +#: ../../page.rst:54 890e4ff8da5e4677bef6638cda0d096b +msgid "PDF only: add a \"rubber stamp\" annotation" +msgstr "" + +#: ../../page.rst:55 d8a3cd0da8bb41208b2acf0da77d4bf3 +msgid ":meth:`Page.add_strikeout_annot`" +msgstr "" + +#: ../../page.rst:55 0462a0f90380435e9e2d4a6bde7b823d +msgid "PDF only: add a \"strike-out\" annotation" +msgstr "" + +#: ../../page.rst:56 2c47edb9bb7d40b189c5fc9ab8cd01ae +msgid ":meth:`Page.add_text_annot`" +msgstr "" + +#: ../../page.rst:56 7632b619a12c4960b78262c184881995 +msgid "PDF only: add a comment" +msgstr "" + +#: ../../page.rst:57 e2a50ffaec6848bdb90b84a8849363e2 +msgid ":meth:`Page.add_underline_annot`" +msgstr "" + +#: ../../page.rst:57 0823a6e1322c4df284bf51d7244e3485 +msgid "PDF only: add an \"underline\" annotation" +msgstr "" + +#: ../../page.rst:58 adf9b34a34274a269bf7a8fb855c43d1 +msgid ":meth:`Page.add_widget`" +msgstr "" + +#: ../../page.rst:58 ec6de31a41ae46c0939bce0684a11d91 +msgid "PDF only: add a PDF Form field" +msgstr "" + +#: ../../page.rst:59 cc58685c609c43dba97e04ba5d192bd4 +msgid ":meth:`Page.annot_names`" +msgstr "" + +#: ../../page.rst:59 a9e0a8b4e8144f70b05ca34d948bd001 +msgid "PDF only: a list of annotation (and widget) names" +msgstr "" + +#: ../../page.rst:60 67dae59b0b5441a0878c34e592fae1ce +msgid ":meth:`Page.annot_xrefs`" +msgstr "" + +#: ../../page.rst:60 2208e830b0af4a299fba78351ccd8ad5 +msgid "PDF only: a list of annotation (and widget) xrefs" +msgstr "" + +#: ../../page.rst:61 230c38ee1238482eb924f6f63c236c85 +msgid ":meth:`Page.annots`" +msgstr "" + +#: ../../page.rst:61 9f1150592cd74dec81a42a8cae1d1acb +msgid "return a generator over the annots on the page" +msgstr "" + +#: ../../page.rst:62 e46aa43cf83d4e5ca6322f8499178e23 +msgid ":meth:`Page.apply_redactions`" +msgstr "" + +#: ../../page.rst:62 08451c9033f245548a5bd811622502a9 +msgid "PDF only: process the redactions of the page" +msgstr "" + +#: ../../page.rst:63 ee5cc3a768064072a5c623772c97b2f7 +msgid ":meth:`Page.bound`" +msgstr "" + +#: ../../page.rst:63 ../../page.rst:129 0bcedf83381a4c9abc256167a10c1d25 +#: fef7250af8c0498daddce6b12f78316e +msgid "rectangle of the page" +msgstr "" + +#: ../../page.rst:64 4820152d01cb4a769e22c41e75fcb7b6 +msgid ":meth:`Page.delete_annot`" +msgstr "" + +#: ../../page.rst:64 618148fbddb04144a5ed42246badfd89 +msgid "PDF only: delete an annotation" +msgstr "" + +#: ../../page.rst:65 7c6aacd3d1fb43508e9234d560d331bc +msgid ":meth:`Page.delete_image`" +msgstr "" + +#: ../../page.rst:65 2458b13098e240628c4f9ec7cd2bbdf2 +msgid "PDF only: delete an image" +msgstr "" + +#: ../../page.rst:66 09cad762d0924fb38bb4bbda7540ea23 +msgid ":meth:`Page.delete_link`" +msgstr "" + +#: ../../page.rst:66 ee5d31e674a948e296da00b9c49f80d3 +msgid "PDF only: delete a link" +msgstr "" + +#: ../../page.rst:67 1e2356b9ca4f476587b7039f80d677eb +msgid ":meth:`Page.delete_widget`" +msgstr "" + +#: ../../page.rst:67 5e9728a5686a488d8e36dfb97b0c95bd +msgid "PDF only: delete a widget / field" +msgstr "" + +#: ../../page.rst:68 c3bdf15c790d48dea2d170a41162a3cb +msgid ":meth:`Page.draw_bezier`" +msgstr "" + +#: ../../page.rst:68 f974910d00d4472c968b670ffb2728af +msgid "PDF only: draw a cubic Bezier curve" +msgstr "" + +#: ../../page.rst:69 ca8fa98fac4244868db24dd54f5fb55f +msgid ":meth:`Page.draw_circle`" +msgstr "" + +#: ../../page.rst:69 e0f077373b0e4224a8bd9ef5c82eeafd +msgid "PDF only: draw a circle" +msgstr "" + +#: ../../page.rst:70 420425dda5f940459f9286fab460a205 +msgid ":meth:`Page.draw_curve`" +msgstr "" + +#: ../../page.rst:70 b98b2273d40649c29d2374d58c68739e +msgid "PDF only: draw a special Bezier curve" +msgstr "" + +#: ../../page.rst:71 1799716e952543f6a64d10d61460a2a8 +msgid ":meth:`Page.draw_line`" +msgstr "" + +#: ../../page.rst:71 44091cbb5197438c8402157b0eecc119 +msgid "PDF only: draw a line" +msgstr "" + +#: ../../page.rst:72 6af24e3f07284050a37d84683915a224 +msgid ":meth:`Page.draw_oval`" +msgstr "" + +#: ../../page.rst:72 5d5dc891350e465292e9bcd5b0ba927f +msgid "PDF only: draw an oval / ellipse" +msgstr "" + +#: ../../page.rst:73 063885ff8942419890179c1d311501dc +msgid ":meth:`Page.draw_polyline`" +msgstr "" + +#: ../../page.rst:73 7309d55cdfc14c77b10cada388d0ae1d +msgid "PDF only: connect a point sequence" +msgstr "" + +#: ../../page.rst:74 ebc94853f2c2402c9db7fdbe932edd83 +msgid ":meth:`Page.draw_quad`" +msgstr "" + +#: ../../page.rst:74 51e2d2eb476c40189674746a3e1f42dc +msgid "PDF only: draw a quad" +msgstr "" + +#: ../../page.rst:75 c9ea1a68c1404fb6b08374804faed950 +msgid ":meth:`Page.draw_rect`" +msgstr "" + +#: ../../page.rst:75 dfb6d896b53446b2b64938c488a35df4 +msgid "PDF only: draw a rectangle" +msgstr "" + +#: ../../page.rst:76 4c62c84915354459866a888cf98c7c51 +msgid ":meth:`Page.draw_sector`" +msgstr "" + +#: ../../page.rst:76 928f8b04ccbd485eb224e652633b711d +msgid "PDF only: draw a circular sector" +msgstr "" + +#: ../../page.rst:77 20bf755e568d4b47a19910c2ce58210a +msgid ":meth:`Page.draw_squiggle`" +msgstr "" + +#: ../../page.rst:77 00ae4fe127dd41ce8b18cb37f36f71cd +msgid "PDF only: draw a squiggly line" +msgstr "" + +#: ../../page.rst:78 3854c467dbbd4bb2973f208705fab27d +msgid ":meth:`Page.draw_zigzag`" +msgstr "" + +#: ../../page.rst:78 dccd0af7dd0d46979e9295d3f82ec917 +msgid "PDF only: draw a zig-zagged line" +msgstr "" + +#: ../../page.rst:79 56011550f10d4fbdbabf08fdb3e432a1 +msgid ":meth:`Page.get_drawings`" +msgstr "" + +#: ../../page.rst:79 f5c33c08e62249a6ad6a1e72d06bf6f1 +msgid "get vector graphics on page" +msgstr "" + +#: ../../page.rst:80 ../../page.rst:1850 abaae3864b7d497a9840de3e260c2ff4 +#: e94e5ee625d34dfe9da6c5f3a1253740 +msgid ":meth:`Page.get_fonts`" +msgstr "" + +#: ../../page.rst:80 483491e9826d4509bfa2b7693b301ff0 +msgid "PDF only: get list of referenced fonts" +msgstr "" + +#: ../../page.rst:81 396a1fd8d0f34c38864a85dc7c08d00d +msgid ":meth:`Page.get_image_bbox`" +msgstr "" + +#: ../../page.rst:81 23bcd25ba89b4ff488234b2431092090 +msgid "PDF only: get bbox and matrix of embedded image" +msgstr "" + +#: ../../page.rst:82 70e296c947f24888b93e62994172b400 +msgid ":meth:`Page.get_image_info`" +msgstr "" + +#: ../../page.rst:82 3b7f21b8d8a045b1b0bcfdac4c9d9a7f +msgid "get list of meta information for all used images" +msgstr "" + +#: ../../page.rst:83 1af40bde656e41a0b75794ca47fec554 +msgid ":meth:`Page.get_image_rects`" +msgstr "" + +#: ../../page.rst:83 aaecad27263c46c4b56765df2f7bd2e2 +msgid "PDF only: improved version of :meth:`Page.get_image_bbox`" +msgstr "" + +#: ../../page.rst:84 ../../page.rst:1851 22c829393b694192957e0782252255f8 +#: d57ba9f6fc7b4dec941b812a37df4aa6 +msgid ":meth:`Page.get_images`" +msgstr "" + +#: ../../page.rst:84 deb2d05f05c04c4889d9ef7e588d79bc +msgid "PDF only: get list of referenced images" +msgstr "" + +#: ../../page.rst:85 5d0450e1322b45b59ab487f8795eff27 +msgid ":meth:`Page.get_label`" +msgstr "" + +#: ../../page.rst:85 ea8f3c47324f44eb84453e89ca5dd78e +msgid "PDF only: return the label of the page" +msgstr "" + +#: ../../page.rst:86 6df0e3160697457d85fea57a9f1201b3 +msgid ":meth:`Page.get_links`" +msgstr "" + +#: ../../page.rst:86 4d284c91a6404aac9031501b85f1d97a +msgid "get all links" +msgstr "" + +#: ../../page.rst:87 ../../page.rst:1852 73fdec3bf9c94be38c3b15d9ea8b638b +#: 83739f05d9814aaeb2c18ebe98ae9986 +msgid ":meth:`Page.get_pixmap`" +msgstr "" + +#: ../../page.rst:87 c965c038d0a34639b377ab8456348774 +msgid "create a page image in raster format" +msgstr "" + +#: ../../page.rst:88 8f01572da100460895582977632ecde5 +msgid ":meth:`Page.get_svg_image`" +msgstr "" + +#: ../../page.rst:88 6629e29e390c429596e76eacddcc8dee +msgid "create a page image in SVG format" +msgstr "" + +#: ../../page.rst:89 ../../page.rst:1853 566e41cfcebd499e83febf44072aade8 +#: ef5103e48dda4217a200669756c7227f +msgid ":meth:`Page.get_text`" +msgstr "" + +#: ../../page.rst:89 544a10228073489ba7bc1ada7b295449 +msgid "extract the page's text" +msgstr "" + +#: ../../page.rst:90 1ebcd5b687ea42929295acf86dbc3958 +msgid ":meth:`Page.get_textbox`" +msgstr "" + +#: ../../page.rst:90 3d6d02815c3545bcb1798bef9489f5fc +msgid "extract text contained in a rectangle" +msgstr "" + +#: ../../page.rst:91 3e042443fa4640fda884eeed6038c5c6 +msgid ":meth:`Page.get_textpage_ocr`" +msgstr "" + +#: ../../page.rst:91 c49e73b4789343c5806f2922836c6fa0 +msgid "create a TextPage with OCR for the page" +msgstr "" + +#: ../../page.rst:92 a012ba7f78d140f3a813b726c4f6b2a5 +msgid ":meth:`Page.get_textpage`" +msgstr "" + +#: ../../page.rst:92 79c21ae1038c497da6c069f6a240b3b8 +msgid "create a TextPage for the page" +msgstr "" + +#: ../../page.rst:93 720bfbaec3f64e9ba72f49c4ebd3e474 +msgid ":meth:`Page.get_xobjects`" +msgstr "" + +#: ../../page.rst:93 dfccf518b07547bf86906b0e334a93f9 +msgid "PDF only: get list of referenced xobjects" +msgstr "" + +#: ../../page.rst:94 35b1bd74307b4cfc9c47d25010dd7791 +msgid ":meth:`Page.insert_font`" +msgstr "" + +#: ../../page.rst:94 aa96676830884350b380e5265199e27b +msgid "PDF only: insert a font for use by the page" +msgstr "" + +#: ../../page.rst:95 d3c2617be48b4e34be21fe920dc13861 +msgid ":meth:`Page.insert_image`" +msgstr "" + +#: ../../page.rst:95 ac815c9773cd4d48ab68aa9654b0fa7c +msgid "PDF only: insert an image" +msgstr "" + +#: ../../page.rst:96 f8637c2385d44f2db98bbc3f0fd3baa7 +msgid ":meth:`Page.insert_link`" +msgstr "" + +#: ../../page.rst:96 fb1951c7f7974cbbb70742b5d0ec80bd +msgid "PDF only: insert a link" +msgstr "" + +#: ../../page.rst:97 0279e5892f5544059c7a434716770c04 +msgid ":meth:`Page.insert_text`" +msgstr "" + +#: ../../page.rst:97 af654281db1742979e359925b9c3cf86 +msgid "PDF only: insert text" +msgstr "" + +#: ../../page.rst:98 a7763159712348da91aac6aab97086a8 +msgid ":meth:`Page.insert_textbox`" +msgstr "" + +#: ../../page.rst:98 e68d3fa92b554fb6920f74a229948b2e +msgid "PDF only: insert a text box" +msgstr "" + +#: ../../page.rst:99 fd2b4ba9b6c342e9838b4d42fc5010b9 +msgid ":meth:`Page.links`" +msgstr "" + +#: ../../page.rst:99 5d158ce033ea4f06a825d73ee939c578 +msgid "return a generator of the links on the page" +msgstr "" + +#: ../../page.rst:100 86b6f6f9b2c64f0b9626f93ebae10457 +msgid ":meth:`Page.load_annot`" +msgstr "" + +#: ../../page.rst:100 6f31c941ba324d878aae869f760ebf32 +msgid "PDF only: load a specific annotation" +msgstr "" + +#: ../../page.rst:101 f18e1f5568754ba48f1a3663f61eb35f +msgid ":meth:`Page.load_widget`" +msgstr "" + +#: ../../page.rst:101 313d444ec46b41edb16f7dd10b38745f +msgid "PDF only: load a specific field" +msgstr "" + +#: ../../page.rst:102 16417be7d7ef44bebe9640201a754531 +msgid ":meth:`Page.load_links`" +msgstr "" + +#: ../../page.rst:102 0c65ea5b3d9446639854c9e704036d41 +msgid "return the first link on a page" +msgstr "" + +#: ../../page.rst:103 e00ad75cd11e4ba4a533abc715a186e8 +msgid ":meth:`Page.new_shape`" +msgstr "" + +#: ../../page.rst:103 ab83aaa3c4774eef843c9a8038a15d87 +msgid "PDF only: create a new :ref:`Shape`" +msgstr "" + +#: ../../page.rst:104 68248813ae604335a78d870e694f2583 +msgid ":meth:`Page.replace_image`" +msgstr "" + +#: ../../page.rst:104 29c3a34f61a2482e8900512c428308c9 +msgid "PDF only: replace an image" +msgstr "" + +#: ../../page.rst:105 ../../page.rst:1854 2f547bda531046abb765077dcbd82c25 +#: b6c183ca5a224fef841cabc01e482bf7 +msgid ":meth:`Page.search_for`" +msgstr "" + +#: ../../page.rst:105 f6991b22801f479a89a179c16b29afc4 +msgid "search for a string" +msgstr "" + +#: ../../page.rst:106 da5c0726c3c54a1e8bfca44264ea23c5 +msgid ":meth:`Page.set_artbox`" +msgstr "" + +#: ../../page.rst:106 63210ccf6e624fc8aa7e9f5fbdeb7327 +msgid "PDF only: modify `/ArtBox`" +msgstr "" + +#: ../../page.rst:107 89a208213acb45b9bad5670ea26384b1 +msgid ":meth:`Page.set_bleedbox`" +msgstr "" + +#: ../../page.rst:107 ea71387c03474d3cb809ebaccc3e603c +msgid "PDF only: modify `/BleedBox`" +msgstr "" + +#: ../../page.rst:108 8b426af4fc5f4ca1a800bf9d5e6526af +msgid ":meth:`Page.set_cropbox`" +msgstr "" + +#: ../../page.rst:108 6d50c038799a46fdb7868df7f5796d03 +msgid "PDF only: modify the :data:`cropbox` (visible page)" +msgstr "" + +#: ../../page.rst:109 3c3427efdbcb43a59f58ce77d3a0df6e +msgid ":meth:`Page.set_mediabox`" +msgstr "" + +#: ../../page.rst:109 8bf9f8c51ed64d7db5bedf9138a57631 +msgid "PDF only: modify `/MediaBox`" +msgstr "" + +#: ../../page.rst:110 170bf2dc756d428e8d38d88bb95d4493 +msgid ":meth:`Page.set_rotation`" +msgstr "" + +#: ../../page.rst:110 406df9944b9144aaaa73e39f81d7650a +msgid "PDF only: set page rotation" +msgstr "" + +#: ../../page.rst:111 8c1828f7286240f7be3bc0d2011947a1 +msgid ":meth:`Page.set_trimbox`" +msgstr "" + +#: ../../page.rst:111 b80667bc4900456f9fe4d002a3a7cb00 +msgid "PDF only: modify `/TrimBox`" +msgstr "" + +#: ../../page.rst:112 04d98da1f57d4a5d8171702474dfc0c9 +msgid ":meth:`Page.show_pdf_page`" +msgstr "" + +#: ../../page.rst:112 94ccc827cef44c4fa28abf67d0fefdce +msgid "PDF only: display PDF page image" +msgstr "" + +#: ../../page.rst:113 e17a17a61bb9481e9d9152615cc133a6 +msgid ":meth:`Page.update_link`" +msgstr "" + +#: ../../page.rst:113 8aa7b9d43c684b389261bfec4168828d +msgid "PDF only: modify a link" +msgstr "" + +#: ../../page.rst:114 85dd1295ad164e50ab12b6f419a04ca3 +msgid ":meth:`Page.widgets`" +msgstr "" + +#: ../../page.rst:114 21a8a3ed70cc4e77a3f2a4a23f221dd6 +msgid "return a generator over the fields on the page" +msgstr "" + +#: ../../page.rst:115 ed592ed9cb12438184349d1561b52aed +msgid ":meth:`Page.write_text`" +msgstr "" + +#: ../../page.rst:115 601867564ce74d879d4ea34a98c38a9f +msgid "write one or more :ref:`Textwriter` objects" +msgstr "" + +#: ../../page.rst:116 59347a27d17749ea851bd14470d522d2 +msgid ":attr:`Page.cropbox_position`" +msgstr "" + +#: ../../page.rst:116 7d11a149095a4e2c9f9ab5b910131ad5 +msgid "displacement of the :data:`cropbox`" +msgstr "" + +#: ../../page.rst:117 e67da4bcf8ea4584ad9be0ec371c52e1 +msgid ":attr:`Page.cropbox`" +msgstr "" + +#: ../../page.rst:117 7fe95f15201a42fa85f8a41c33c9c2ce +msgid "the page's :data:`cropbox`" +msgstr "" + +#: ../../page.rst:118 235c0518352b47d0924b2e65fcb8191f +msgid ":attr:`Page.artbox`" +msgstr "" + +#: ../../page.rst:118 fe3437ad7d504a72a5a57d1ec3ba0c2e +msgid "the page's `/ArtBox`" +msgstr "" + +#: ../../page.rst:119 cfd6eba1e6ff48c9b97a29ef9b4f608c +msgid ":attr:`Page.bleedbox`" +msgstr "" + +#: ../../page.rst:119 787a4767a042444a9c14232b352a08d7 +msgid "the page's `/BleedBox`" +msgstr "" + +#: ../../page.rst:120 efff3c7dd13143cf8060593d1646b1f4 +msgid ":attr:`Page.trimbox`" +msgstr "" + +#: ../../page.rst:120 23598e68ed5945749b43222ed30bdb02 +msgid "the page's `/TrimBox`" +msgstr "" + +#: ../../page.rst:121 cc03a765573d4e0085ba05dcb0f3c870 +msgid ":attr:`Page.derotation_matrix`" +msgstr "" + +#: ../../page.rst:121 6030db8fd3d44c9484a213b5d9892a0c +msgid "PDF only: get coordinates in unrotated page space" +msgstr "" + +#: ../../page.rst:122 25141032b4ed4a9c8c8916fa4266f154 +msgid ":attr:`Page.first_annot`" +msgstr "" + +#: ../../page.rst:122 7bed5c50525f432c8369311d079a2ad8 +msgid "first :ref:`Annot` on the page" +msgstr "" + +#: ../../page.rst:123 6d568430901b4e3bae8497b6bd60ba3e +msgid ":attr:`Page.first_link`" +msgstr "" + +#: ../../page.rst:123 df548d38e91e466f972956dd1fb32319 +msgid "first :ref:`Link` on the page" +msgstr "" + +#: ../../page.rst:124 72aa453b5f46409f8d7edc1b62f9df1f +msgid ":attr:`Page.first_widget`" +msgstr "" + +#: ../../page.rst:124 45cc4fe985e34802b1a3a1580d039430 +msgid "first widget (form field) on the page" +msgstr "" + +#: ../../page.rst:125 4993ce9cf1e94de49d9f7cbd0f8e364c +msgid ":attr:`Page.mediabox_size`" +msgstr "" + +#: ../../page.rst:125 4e47f63933ed4446a205c424c81d07df +msgid "bottom-right point of :data:`mediabox`" +msgstr "" + +#: ../../page.rst:126 7611b80dee154a718f4aa66e6253d9ee +msgid ":attr:`Page.mediabox`" +msgstr "" + +#: ../../page.rst:126 4d90498c9c2442bea1ea2f808193610b +msgid "the page's :data:`mediabox`" +msgstr "" + +#: ../../page.rst:127 d45ddb5e19da4729bb54b73d41aef50a +msgid ":attr:`Page.number`" +msgstr "" + +#: ../../page.rst:127 bce777190d104084927f8efcada709f7 +msgid "page number" +msgstr "" + +#: ../../page.rst:128 aa161cbfbdca4d99a73fd14bf767057c +msgid ":attr:`Page.parent`" +msgstr "" + +#: ../../page.rst:128 78444c3ecdaf4e78825b07f348888f06 +msgid "owning document object" +msgstr "" + +#: ../../page.rst:129 20ae5b1a37b2423b8a1708a727b16498 +msgid ":attr:`Page.rect`" +msgstr "" + +#: ../../page.rst:130 9a159a2d4d1640b58eda76d639c4d43e +msgid ":attr:`Page.rotation_matrix`" +msgstr "" + +#: ../../page.rst:130 9933d50594b34e82bae4fd9f1be15ed9 +msgid "PDF only: get coordinates in rotated page space" +msgstr "" + +#: ../../page.rst:131 0d81a311198a49958c24555e4881e663 +msgid ":attr:`Page.rotation`" +msgstr "" + +#: ../../page.rst:131 6444dde4b6c0402f943c9f99d639251b +msgid "PDF only: page rotation" +msgstr "" + +#: ../../page.rst:132 bcc07b45ab0d4711968c1a4428f735df +msgid ":attr:`Page.transformation_matrix`" +msgstr "" + +#: ../../page.rst:132 c25546286d444e949dfa8b006342c1a6 +msgid "PDF only: translate between PDF and MuPDF space" +msgstr "" + +#: ../../page.rst:133 818d4dd2fda9403396da239538ed8c50 +msgid ":attr:`Page.xref`" +msgstr "" + +#: ../../page.rst:133 748ab55fb1ec409daaa8756d277b133d +msgid "PDF only: page :data:`xref`" +msgstr "" + +#: ../../page.rst:136 28f2e4cd9235448abab6bbc89e9d56fb +msgid "**Class API**" +msgstr "" + +#: ../../page.rst:142 e5e3a62d2a4542dcb072776db1658d13 +msgid "" +"Determine the rectangle of the page. Same as property :attr:`Page.rect` " +"below. 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 "" + +#: ../../page.rst 01599fc3926c4d04a1bf4a13576618d4 +#: 01615fbeaf6f443ab25d5a5df0d4f41b 181b64abacd841c1b227c8f11915c83f +#: 1aff927b42fe43b5b31968efec14b634 2cf467389f184c1bb758a101027a8bbc +#: 2db6008c43ed4ba9a07350b76f82b93d 335802eb37e34c4ba1882b95372534ab +#: 3598f658489e4b45836d5d32b76c95ff 42a888677a2748e09b74790a15871247 +#: 4c2ef05d11994521a052f645ad5fc674 4f53be986b214c9eb90451534761a614 +#: 5266fe3160ad41239e7cf267f3fc9059 7210a187f57a453b8d33b226af05fc32 +#: 7d7b920b12bd47fcbb03b6cafe30c074 7e399fa7680a4771b5830d3834d137ca +#: 89bbe381fc324398bf3afc40fdbf60ab 8b9869122657401d910eca6c3055728d +#: 92a1e0985fe94215a8e01bfb7e1aed22 999731edab5a42f4b84e70fb8a574165 +#: abae8d8b23b043938b4076ec00ab43bb b8e95059debb4c10baebaf3726ab46ac +#: bc0a5f0405c04005b5cf7f24a304b734 be59bdbc5c994393a03c9d5eda71aa6a +#: bfefe4fcc9f4493aad51159483e9345e ceb9c035a88d4f4d8d6a23de02df7efb +#: d85be6429d19425c81edefa2b8234d26 d906d89cbddd4e7d95ffa43356a199f3 +#: daad9a616b944098834513346adeefb5 e4e05f0ffe7e4f0d81c64ab3b211fbb8 +#: e6f2232764c442d295ae30d7c6b1fbd5 fb591127250c44d5869784672bb6180c +msgid "Return type" +msgstr "" + +#: ../../page.rst:144 ../../page.rst:1699 ../../page.rst:1709 +#: ../../page.rst:1721 ../../page.rst:1782 ../../page.rst:1788 +#: 0f70eb0083aa49a5a50adbeb8da5991c 11d9cfd248684449af6ccac42ed0a5e5 +#: 5bc248e8383f42f88dd5608eced0ee45 c8bfd9040f7642439a23e8746fc35f32 +#: e64ef03244c544049f40dd4a08886fae edea7d0547ce4d1c9a70595a4c7e4f03 +msgid ":ref:`Rect`" +msgstr "" + +#: ../../page.rst:148 9368fffed9da4ef994e122d22f4d3ef2 +msgid "New in v1.16.0" +msgstr "" + +#: ../../page.rst:150 e671944b5fc94d33bbcff3ef9888564e +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 "" + +#: ../../page.rst 0435b61036a440b88b5a580794bd8ac7 +#: 0907875ea22943ffb6261225b027b3dc 158dd93b152742e8af084059a69625fc +#: 248857a6c7324b638d596e1dc081bdef 2fc8d061ce6643c2a7c65755c100cca6 +#: 321b463f4fbd4206b3c4e3ff04d43309 36a84a3921844594a641adc946d7aa96 +#: 49f11095992c46a7ac26e414d9141196 51d21582c50a463398bbefd698a25f80 +#: 553b218b0661432e9331b500359ba5c1 5d22c8b5ccc04119b00b3299906247fd +#: 5eaa0d8e92bb4d12b3a52061103816ad 660d743337a6468d84ea0b851ea1d55b +#: 662424aa4beb4be18b079a9d52ad4ea3 6c639641d02b424294f80eeffd5128b0 +#: 7351756207d8492abce14daea95b15fc 7e52102756f44aa68e71a3d63c4a54e2 +#: 8b25bf6a67424d088ad7fef1bf95be29 905a8ff5b3b848cf8a646f2588c4e347 +#: 90674d638cf14cfd9936055301d136c4 9709377f8b58444881b6ebf0d0a9f90c +#: a066b99db4134e19b02fc7b7ed3ea21e a7302b70ae0f48f5a3d5aacd09b028ba +#: adce0ef849a94f779a231a014b685608 af31683a7be847c8a522841dd2085514 +#: b10c5348bb3e43fabe8f4155ee414ff4 b404c960e2e04e2abcf44de40aa78f06 +#: bff00da4d5ec45dbb36e73956144e3aa c6f4a3aaed684718ab861050823d7236 +#: cafffea7a34a4b6cb0f016c994142ed5 cdf0e1ba07864cd48559fb7884facda6 +#: d79b7463f21e46bcb0f7cbb1283198e6 db129949848a47079b6fe58b60fd6abc +#: dd263c163c8b4efe92bb62b5f53caadf df14b0b1bb374062b96020a4f9ba3d9b +#: e3025314d4a54561ad298a7f486e449a ed01b59eb8ae4c0fbfab908a99f88627 +#: ef9d1386bd054507be2472de372cbe67 f35525808589428e8815ef4c9bdf61db +#: f7fa62ca262e4fbbb5b29b120cc85f5d f8690416ba7c46f4b381ba5351be9812 +#: fb944b295f074a9ca6f540223a0fecf1 fbb8d51e26514288b45e923cf17b8633 +msgid "Parameters" +msgstr "" + +#: ../../page.rst:152 dd4dc88037764f629af2547162c97f18 +msgid "" +"the top left point of a 20 x 20 rectangle containing the MuPDF-provided " +"icon." +msgstr "" + +#: ../../page.rst:154 ../../page.rst:169 ../../page.rst:204 ../../page.rst:222 +#: ../../page.rst:231 ../../page.rst:242 ../../page.rst:253 ../../page.rst:291 +#: ../../page.rst:304 ../../page.rst:387 ../../page.rst:1483 +#: ../../page.rst:1757 079cb096f3f64a3e901f9eb4129bfdcd +#: 18e0ca09e99e474b857f2ff81f97909e 23d9b30d761943e28da3c3cb9df3247d +#: 3afd0c917deb4910bb26a4a2d78fb281 6f78ad95e5074c58bc83aa896614a9c5 +#: 6fd18be1eb6241e6987a76f6a71e941b 96ad5bfbef524e34be3fcfc178ebdaf1 +#: af9420a6547148f9b3e71fd9effed9ba ba6f86da564247779dcd91f87ab5624e +#: c7f2788bd3514850b69ccc47392252ea d2d7451a79db4d8a9679e0b247d0110d +#: dc9f10aea5d84db4aaa2aad314eaf32f +msgid ":ref:`Annot`" +msgstr "" + +#: ../../page.rst 0004726e3c2e4859b6af5473b4ff6ec6 +#: 0388ea8f233e45c2942ff476e99caef2 0ab2fe56c8384b3bbfdfb53a1c840419 +#: 0f791a5bcd8b4d7d8b743245af6fc832 16f2ee4ce3e74c86b01bd8a730b56e04 +#: 17423ac05cfa40a9a97ba298b642b346 26f5c2a368704ad9bf4edb0c4eff8b78 +#: 304c7d45dddd49d8a23ebc265babfaf3 3073bb6d02ea4274b570f1525f19a969 +#: 3e20cd7cd260473d87ca40c59cf88a1b 4265ab4846064d1fa93262ffe29ee28d +#: 4bc0c3134e3f4c1c9df03a18f06fbebb 4dfa48ed9aa349d5b6023642680cd404 +#: 53f33a1a786042ecb53a17c79b015134 55227faefe7e48269f5ff6cc0d8d1449 +#: 5ed55071fdde4470b2a2f92b2eecc208 68a47484764b4790a72ad8fe580a4a87 +#: 6a1f733b120a433e859befd66a726787 6b14700b520440699452c0b2466f98f6 +#: 6d430a6de3544764a31832c73efa140d 72e06beb5dc940359a579d051fe4b1a8 +#: 78e945e12a2c4ce6b41ce65d0e4cbf0c 7dcf6c18810f40db816fba723c51fad0 +#: 8841896a6ca54f1dbf9f6f9c513d9b85 907925d2cbe844108ec2fea629a0bbb4 +#: 9221c2c46e8748bcad2e5f2f1cc3193c 961232f825874a2ba1964ae9f5e031e3 +#: a9a6fa51d7f146b6879a4d6ffe901645 aa3185719ae44a4e99c9818a44c6f941 +#: b3ee5d8c30b647509a72b13ad77f49d4 c12544cc5d0b4de19e1e31e6e42c1e88 +#: c2cea151df114abfac94289da78fe688 ca20cb3ccd3042ce9c7bba4213dce013 +#: cf0eac4a11c5422f9580d13ed52ce099 df7fc7c9d41f49c0bb0958c45f1c6d92 +#: e33dc62aefca4ec8b4847ddbb30955f3 fa2609ac010846dfba39101b99a55abe +msgid "Returns" +msgstr "" + +#: ../../page.rst:155 a1ef4677aeb0472bb3929aa8b78f916d +msgid "" +"the created annotation. Stroke color blue = (0, 0, 1), no fill color " +"support." +msgstr "" + +#: ../../page.rst:162 12b1a198f1f84586bea1c5289d427ca5 +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 "" + +#: ../../page.rst:164 14ea6a6fba2f4f948ae54db8d2997b26 +msgid "" +"the top left point of a 20 x 20 rectangle containing the MuPDF-provided " +"\"note\" icon." +msgstr "" + +#: ../../page.rst:166 526435be54f748f38c47f131b0139e3a +msgid "" +"the commentary text. This will be shown on double clicking or hovering " +"over the icon. May contain any Latin characters." +msgstr "" + +#: ../../page.rst:167 e9db3c19017f4f45a3bb91d570fff533 +msgid "" +"*(new in v1.16.0)* choose one of \"Note\" (default), \"Comment\", " +"\"Help\", \"Insert\", \"Key\", \"NewParagraph\", \"Paragraph\" as the " +"visual symbol for the embodied text [#f4]_." +msgstr "" + +#: ../../page.rst:170 e7eea9186df546bf8019f99e92f3c84b +msgid "" +"the created annotation. Stroke color yellow = (1, 1, 0), no fill color " +"support." +msgstr "" + +#: ../../page.rst:185 52205b97d76348709a4c5f6e83532229 +msgid "Changed in v1.19.6: add border color parameter" +msgstr "" + +#: ../../page.rst:187 fd81386978e34841acb2f5257293c2b5 +msgid "PDF only: Add text in a given rectangle." +msgstr "" + +#: ../../page.rst:189 b00304ad26d14185b7e3676964d80e6c +msgid "" +"the rectangle into which the text should be inserted. Text is " +"automatically wrapped to a new line at box width. Lines not fitting into " +"the box will be invisible." +msgstr "" + +#: ../../page.rst:191 febd87b869634ec3923482742c9a9a39 +msgid "" +"the text. *(New in v1.17.0)* May contain any mixture of Latin, Greek, " +"Cyrillic, Chinese, Japanese and Korean characters. The respective " +"required font is automatically determined." +msgstr "" + +#: ../../page.rst:192 783f69bbd95f446db1adb9e497d8cb34 +msgid "the font size. Default is 12." +msgstr "" + +#: ../../page.rst:193 34623ed5fb164f41a86f5be86997a069 +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 "" + +#: ../../page.rst:194 c8b3ed3990a8486ebef865c0e5899806 +msgid "*(new in v1.16.0)* the text color. Default is black." +msgstr "" + +#: ../../page.rst:196 9a04b088a6bf4c40af86481a128b8ac4 +msgid "*(new in v1.16.0)* the fill color. Default is white." +msgstr "" + +#: ../../page.rst:197 05d895cda394438b9eea03f5e4428bd0 +msgid "the text color. Default is black." +msgstr "" + +#: ../../page.rst:198 c21a96bf9cb842e4904ccd8740acab41 +msgid "*(new in v1.19.6)* the border color. Default is `None`." +msgstr "" + +#: ../../page.rst:199 1a7f6293d8b94bf590e18f5d76bf89f8 +msgid "" +"*(new in v1.17.0)* text alignment, one of TEXT_ALIGN_LEFT, " +"TEXT_ALIGN_CENTER, TEXT_ALIGN_RIGHT - justify is **not supported**." +msgstr "" + +#: ../../page.rst:202 69a4c1be53024671b2573b234b12bc78 +msgid "" +"the text orientation. Accepted values are 0, 90, 270, invalid entries are" +" set to zero." +msgstr "" + +#: ../../page.rst:205 80aff46fabfe41dda393fc06a10f226f +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 "" + +#: ../../page.rst:209 d6c18c268d3f4971bba06a3a57883e7f +msgid "" +"PDF only: Add a file attachment annotation with a \"PushPin\" icon at the" +" specified location." +msgstr "" + +#: ../../page.rst:211 b116c03d1eb0494194e3841b96d50f8d +msgid "" +"the top-left point of a 18x18 rectangle containing the MuPDF-provided " +"\"PushPin\" icon." +msgstr "" + +#: ../../page.rst:213 af5e64af9c9a44898ec10c7b4e7abe00 +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:213 0cf97ad8aaa6455589435fffa2d6c0d9 +msgid "the data to be stored (actual file content, any data, etc.)." +msgstr "" + +#: ../../page.rst:215 76e93a21ee784fa18fc8560524c37fa1 +msgid "Changed in v1.14.13 *io.BytesIO* is now also supported." +msgstr "" + +#: ../../page.rst:217 e3a95a691be54c038a479c26c117fb84 +msgid "the filename to associate with the data." +msgstr "" + +#: ../../page.rst:218 43b9fd8ea5a7474abe643cb1757ce1b0 +msgid "the optional PDF unicode version of filename. Defaults to filename." +msgstr "" + +#: ../../page.rst:219 c4b5bfb23c4a4f4f83acc78ffee842d8 +msgid "an optional description of the file. Defaults to filename." +msgstr "" + +#: ../../page.rst:220 3cc4d72d30cc4f39aceb1ba33264b5a7 +msgid "" +"*(new in v1.16.0)* choose one of \"PushPin\" (default), \"Graph\", " +"\"Paperclip\", \"Tag\" as the visual symbol for the attached data [#f4]_." +msgstr "" + +#: ../../page.rst:223 f3e1da994e5641e98c4e1634af97673b +msgid "" +"the created annotation. Stroke color yellow = (1, 1, 0), no fill color " +"support." +msgstr "" + +#: ../../page.rst:227 086bdfec47fb45bf9d12bee2c22d70f8 +msgid "PDF only: Add a \"freehand\" scribble annotation." +msgstr "" + +#: ../../page.rst:229 18566ed8f4c44b318de9b8b6783d8899 +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 "" + +#: ../../page.rst:232 97016ba7ae174da296411c26a96564ac +msgid "" +"the created annotation in default appearance black =(0, 0, 0),line width " +"1. No fill color support." +msgstr "" + +#: ../../page.rst:236 5c4dad20ff564ec6a4f9b55f87da84f9 +msgid "PDF only: Add a line annotation." +msgstr "" + +#: ../../page.rst:238 3fef4f946a47435cac9ecf7c306d9c1a +msgid "the starting point of the line." +msgstr "" + +#: ../../page.rst:240 23ef7908427f4d64a07d007613385975 +msgid "the end point of the line." +msgstr "" + +#: ../../page.rst:243 803133640786485d9f7c5180c0e854b2 +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 "" + +#: ../../page.rst:249 40cb670e7daa4830b0ec6cb220260c40 +msgid "PDF only: Add a rectangle, resp. circle annotation." +msgstr "" + +#: ../../page.rst:251 9f700b5f63484cb8b17dd68eaa266676 +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:254 19355b288d48439ea8bd5e62cdc044ee +msgid "" +"the created annotation. It is drawn with line (stroke) color red = (1, 0," +" 0), line width 1, fill color is supported." +msgstr "" + +#: ../../page.rst:258 ../../page.rst:404 3f47d4cf566b406a94e0b8be79affaee +#: d032c218346f4aceb39f2764bb4ba284 +msgid "New in v1.16.11" +msgstr "" + +#: ../../page.rst:260 e10d738a0eae4d7d9b7f8b272aa28c80 +msgid "" +"PDF only: Add a redaction annotation. A redaction annotation identifies " +"content to 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 "" + +#: ../../page.rst:262 5617886ba5ce4b6f94a69965d791f940 +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 "" + +#: ../../page.rst:264 2f1f8c0b723b4aa298f343456c595a60 +msgid "" +"*(New in v1.16.12)* text to be placed in the rectangle after applying the" +" redaction (and thus removing old content)." +msgstr "" + +#: ../../page.rst:266 f4da9c6eb8f348acb9d9642f78ab9f27 +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 "" + +#: ../../page.rst:266 9860e39e900146b99de30743b5965e46 +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`." +msgstr "" + +#: ../../page.rst:270 17a03c6390944fd69fa78ecc00675850 +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 "" + +#: ../../page.rst:271 d22c186d0c11449885114bbb05a23921 +msgid "For a **new, non-builtin** font, proceed as follows::" +msgstr "" + +#: ../../page.rst:281 5b2e3f425e094825bad48ebf40adee9d +msgid "" +"*(New in v1.16.12)* the fontsize to use for the replacing text. If the " +"text is too large to fit, several insertion attempts will be made, " +"gradually reducing the fontsize to no less than 4. If then the text will " +"still not fit, no text insertion will take place at all." +msgstr "" + +#: ../../page.rst:283 78526c39fcf34584bffb705d7f329a2e +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 "" + +#: ../../page.rst:285 78483220c16b49828632258459929177 +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 "" + +#: ../../page.rst:287 e8158192360b495c8a1a76218cd9bdca +msgid "" +"*(New in v1.16.12)* the color of the replacing text. Default is *black = " +"(0, 0, 0)*." +msgstr "" + +#: ../../page.rst:289 ae909476caa14095be54a0e9adfe6c2c +msgid "*(new in v1.17.2)* add two diagonal lines to the annotation rectangle." +msgstr "" + +#: ../../page.rst:292 23c4af8bf2d147eb8259b6136db79df2 +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 "" + +#: ../../page.rst:300 79f95be8e9a64fdaaf816fb7ea961168 +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 "" + +#: ../../page.rst:302 6fd9cce8d32b46898b64aa50e1fb3f55 +msgid "a list of :data:`point_like` objects." +msgstr "" + +#: ../../page.rst:305 4ed07e0645da4eaa875af8ade8d216a2 +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 "" + +#: ../../page.rst:318 cab58bd5bb974fc29f3426462af2eabf +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 "" + +#: ../../page.rst:320 7d11d2f03ba64c61853d83834f5a638e +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:322 34d63661d0cc4f72a2c9665756d9b5ee +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 "" + +#: ../../page.rst:326 130e312e488e4d7ea3791d3d9a4da914 +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 "" + +#: ../../page.rst:333 b43681e0c225430d956859ad8bf4ee83 +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 reactangle." +msgstr "" + +#: ../../page.rst:335 0a7955a064494ea8b20ff0e239ffea63 +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 "" + +#: ../../page.rst:337 e8182169ca1e4135bacfc460ebef72f2 +msgid "" +"*(Changed in v1.14.20)* the location(s) -- rectangle(s) or quad(s) -- to " +"be marked. 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). *(Changed in v1.16.14)* " +"**Set this parameter to** *None* if you want to use the following " +"arguments. And vice versa: if not *None*, the remaining parameters must " +"be *None*." +msgstr "" + +#: ../../page.rst:338 76eecfff18204e7cacc8437dcab9287e +msgid "" +"*(New in v1.16.14)* start text marking at this point. Defaults to the " +"top-left point of *clip*. Must be provided if `quads` is *None*." +msgstr "" + +#: ../../page.rst:339 913e07be76c24db2b46f44d721ce1556 +msgid "" +"*(New in v1.16.14)* stop text marking at this point. Defaults to the " +"bottom-right point of *clip*. Must be used if `quads` is *None*." +msgstr "" + +#: ../../page.rst:340 e7271599b9434fab8fc0dbabf9bb5364 +msgid "" +"*(New in v1.16.14)* only consider text lines intersecting this area. " +"Defaults to the page rectangle. Only use if `start` and `stop` are " +"provided." +msgstr "" + +#: ../../page.rst:342 f8fb40b9c74e4089a8946a5e82b7b366 +msgid ":ref:`Annot` or *(changed in v1.16.14)* *None*" +msgstr "" + +#: ../../page.rst:343 ffc1d4cc20cd436b849e3cc2f15b771f +msgid "" +"the created annotation. *(Changed in v1.16.14)* If *quads* is an empty " +"list, **no annotation** is created." +msgstr "" + +#: ../../page.rst:345 17a87edd5e1b463b9b8cf0db2736f82f +msgid "" +"Starting with v1.16.14 you can use parameters *start*, *stop* and *clip* " +"to highlight consecutive lines between the points *start* and *stop*. " +"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 "" + +#: ../../page.rst:352 e2e948fe2bd141c093c24c86fb8b47b8 +msgid "" +"PDF only: Add a \"rubber stamp\" like annotation to e.g. indicate the " +"document's intended use (\"DRAFT\", \"CONFIDENTIAL\", etc.)." +msgstr "" + +#: ../../page.rst:354 0734da58d4934231b6272b755b44ebc3 +msgid "rectangle where to place the annotation." +msgstr "" + +#: ../../page.rst:356 0208cd1a346944ba91754b58100d158f +msgid "id number of the stamp text. For available stamps see :ref:`StampIcons`." +msgstr "" + +#: ../../page.rst:360 60134f90b22b48d7a7ba988dd4e08570 +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 "" + +#: ../../page.rst:361 1367193f730f4bbcaa7000140dcbf963 +msgid "The font chosen is \"Times Bold\" and the text will be upper case." +msgstr "" + +#: ../../page.rst:362 c6eacd1941e9465e8faab67d1195b73e +msgid "" +"The appearance can be changed using :meth:`Annot.set_opacity` and by " +"setting the \"stroke\" color (no \"fill\" color supported)." +msgstr "" + +#: ../../page.rst:363 6a14926af9fb4589928e4214264bc35c +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 "" + +#: ../../page.rst:371 eb4a6e86b52c42e68c449a2a3b3d79d8 +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 "" + +#: ../../page.rst:373 eadebe77101c4a10a896a71bfeb30580 +msgid "a :ref:`Widget` object which must have been created upfront." +msgstr "" + +#: ../../page.rst:376 f16262ce435b486cbcfda46e048fa58a +msgid "a widget annotation." +msgstr "" + +#: ../../page.rst:380 b2c6cbd3709848c98eaaae9ff782526c +msgid "" +"Changed in v1.16.6: The removal will now include any bound 'Popup' or " +"response annotations and related objects." +msgstr "" + +#: ../../page.rst:382 d26a1e5415b34415abb6f010131c9310 +msgid "PDF only: Delete annotation from the page and return the next one." +msgstr "" + +#: ../../page.rst:384 7c9c07351b42425a9d3e34f6639059d1 +msgid "the annotation to be deleted." +msgstr "" + +#: ../../page.rst:388 86b11b9d2b41425ba6d6a2aee2eda020 +msgid "" +"the annotation following the deleted one. Please remember that physical " +"removal requires saving to a new file with garbage > 0." +msgstr "" + +#: ../../page.rst:392 40a458a293304e7c8c90ded8c14f6353 +msgid "New in v1.18.4" +msgstr "" + +#: ../../page.rst:394 89bf3cb9107b4e1cb2705bd247406866 +msgid "PDF only: Delete field from the page and return the next one." +msgstr "" + +#: ../../page.rst:396 4b66e28343bb4f4bbe180b22c1cbfa15 +msgid "the widget to be deleted." +msgstr "" + +#: ../../page.rst:399 ../../page.rst:1496 ../../page.rst:1763 +#: 1f6e01624ba24385ac0552f2520ef215 bf40cbcc842943f09e3268e909b468b6 +#: ec887a14f0a24021946ff2b4246afa16 +msgid ":ref:`Widget`" +msgstr "" + +#: ../../page.rst:400 6609cdb5926442669f7b8c205d42b059 +msgid "" +"the widget following the deleted one. Please remember that physical " +"removal requires saving to a new file with garbage > 0." +msgstr "" + +#: ../../page.rst:405 34a8dd1c6b4541febe5a70231add6db0 +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 "" + +#: ../../page.rst:406 1db1bc0928114559a964cbedae95b777 +msgid "" +"Changed in v1.18.0: added option for handling images that overlap " +"redaction areas." +msgstr "" + +#: ../../page.rst:408 45f8563d884043b4b95966561cef30d7 +msgid "" +"PDF only: Remove all **text content** contained in any redaction " +"rectangle." +msgstr "" + +#: ../../page.rst:410 48bd71e0a03e452ca7cb7d4369b575ad +msgid "**This method applies and then deletes all redactions from the page.**" +msgstr "" + +#: ../../page.rst:412 8e9b64e6da8040c28468434cbc19e3b5 +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 "" + +#: ../../page.rst:415 f7be2a224c244839a436dd2f88a2ca85 +msgid "" +"*True* if at least one redaction annotation has been processed, *False* " +"otherwise." +msgstr "" + +#: ../../page.rst:418 d7a897c039d94e869e1116b61c97f74e +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 "" + +#: ../../page.rst:420 daee259b85f44cdabe8a22d03f9bdc68 +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:422 ac81fef580f74d15983c5fc8b7a1a46f +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 "" + +#: ../../page.rst:424 f9e589e64ebc45dcaeb292de56a9c705 +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 "" + +#: ../../page.rst:426 0ad3035316334d65b26c8dcca764d387 +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 "" + +#: ../../page.rst:428 cf18adfba1744c8ba885a613c3292fe5 +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 "" + +#: ../../page.rst:430 61aec0abf5414828a6fa7e6e8e581bdf +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 "" + +#: ../../page.rst:432 74b90afba78745fa94969340c0744528 +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:434 b37ca79203a54f6782a8bf5b4de23a4b +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 "" + +#: ../../page.rst:438 2e545174b64349e1b2adcd5d0473b656 +msgid "" +"PDF only: Delete the specified link from the page. The parameter must be " +"an **original item** of :meth:`get_links()` (see below). The reason for " +"this is the dictionary's *\"xref\"* key, which identifies the PDF object " +"to be deleted." +msgstr "" + +#: ../../page.rst:440 e95794b552e746fab20d128f738e618e +msgid "the link to be deleted." +msgstr "" + +#: ../../page.rst:444 6de1e416aafb45cc811734f1f3f20269 +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 below)." +msgstr "" + +#: ../../page.rst:446 77bc3b00bebd4c62b426124e9cb31631 +msgid "the link to be inserted." +msgstr "" + +#: ../../page.rst:450 2966d6e1d3ac4c11ab414cea8cc9465b +msgid "" +"PDF only: Modify the specified link. The parameter must be a (modified) " +"**original item** of :meth:`get_links()` (see below). The reason for this" +" is the dictionary's *\"xref\"* key, which identifies the PDF object to " +"be changed." +msgstr "" + +#: ../../page.rst:452 243565b57cc04138b86aba8de29b7ae3 +msgid "the link to be modified." +msgstr "" + +#: ../../page.rst:454 ee1e996b0f6f462bb29fc709c3c4aa8f +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 "" + +#: ../../page.rst:459 b751c22ad90b4caa987309963ead7027 +msgid "New in v1.18.6" +msgstr "" + +#: ../../page.rst:461 3686264c11954c8ba12a9456928622ed +msgid "PDF only: Return the label for the page." +msgstr "" + +#: ../../page.rst:465 a8cb84b1242d4713a410b167179a14f5 +msgid "the label string like \"vii\" for Roman numbering or \"\" if not defined." +msgstr "" + +#: ../../page.rst:471 30caab9246c24037a4844602aa78790f +msgid "Retrieves **all** links of a page." +msgstr "" + +#: ../../page.rst:474 1d1e63f0c8164457b42c77f515c7f56c +msgid "" +"A list of dictionaries. For a description of the dictionary entries see " +"below. Always use this or the :meth:`Page.links` method if you intend to " +"make changes to the links of a page." +msgstr "" + +#: ../../page.rst:478 ../../page.rst:489 ../../page.rst:510 +#: 287c1a4bf3004ffba9010cbece445251 2f0ac9cb5e2d47a1a334e64d2220f27c +#: d20727057d0345f58340c2a971ee4ab2 +msgid "New in v1.16.4" +msgstr "" + +#: ../../page.rst:480 16bb202656b24793867b59af5c17ddea +msgid "" +"Return a generator over the page's links. The results equal the entries " +"of :meth:`Page.get_links`." +msgstr "" + +#: ../../page.rst:482 8e354b496c7a422abd6953e22866d499 +msgid "" +"a sequence of integers to down-select to one or more link kinds. Default " +"is all links. Example: *kinds=(fitz.LINK_GOTO,)* will only return " +"internal links." +msgstr "" + +#: ../../page.rst:485 99b2677fdec74744b4b6c4d2fbf34688 +msgid "an entry of :meth:`Page.get_links()` for each iteration." +msgstr "" + +#: ../../page.rst:491 224b78a509b44fd2bd07a7b9edc21d87 +msgid "Return a generator over the page's annotations." +msgstr "" + +#: ../../page.rst:493 fd85b22a44a045879703270c08788bdd +msgid "" +"a sequence of integers to down-select to one or more annotation types. " +"Default is all annotations. Example: `types=(fitz.PDF_ANNOT_FREETEXT, " +"fitz.PDF_ANNOT_TEXT)` will only return 'FreeText' and 'Text' annotations." +msgstr "" + +#: ../../page.rst:496 f96c9ab0a2854b84b1c43f2457b527ec +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:496 6f2bd3069d52451f88579e96d6eb92f5 +msgid "an :ref:`Annot` for each iteration." +msgstr "" + +#: ../../page.rst:499 9ebeaecf545f4ba0a11969cee08265c8 +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.rst:512 e0a0f460de3f4dd080d130b03b816c49 +msgid "Return a generator over the page's form fields." +msgstr "" + +#: ../../page.rst:514 95f6a5bb3bdd4bd2ba3e5521fb542eb2 +msgid "" +"a sequence of integers to down-select to one or more widget types. " +"Default is all form fields. Example: `types=(fitz.PDF_WIDGET_TYPE_TEXT,)`" +" will only return 'Text' fields." +msgstr "" + +#: ../../page.rst:517 12fb96a5d3074932ab8a3c29673829ee +msgid "a :ref:`Widget` for each iteration." +msgstr "" + +#: ../../page.rst:522 b22bcc0acb0f4ff68f71d138eb87fdb6 +msgid "New in v1.16.18" +msgstr "" + +#: ../../page.rst:524 32810697de0046b692571fd684cb2d90 +msgid "" +"PDF only: Write the text of one or more :ref:`Textwriter` objects to the " +"page." +msgstr "" + +#: ../../page.rst:526 0fe862196435459b954df3db02e0bde6 +msgid "" +"where to place the text. If omitted, the rectangle union of the text " +"writers is used." +msgstr "" + +#: ../../page.rst:527 34f70fcfaabe406e86da6d0b83dc02ef +msgid "" +"a non-empty tuple / list of :ref:`TextWriter` objects or a single " +":ref:`TextWriter`." +msgstr "" + +#: ../../page.rst:528 2ba45a05a86149c2a9a49ed999f5c021 +msgid "set transparency, overwrites resp. value in the text writers." +msgstr "" + +#: ../../page.rst:529 fc743f23c334400594b0c016fc097a39 +msgid "set the text color, overwrites resp. value in the text writers." +msgstr "" + +#: ../../page.rst:530 7c6d205a1fac4678842e1caa2c36023b +msgid "put the text in foreground or background." +msgstr "" + +#: ../../page.rst:531 587404afd7304e0a9fb24f8a970ab63b +msgid "maintain the aspect ratio." +msgstr "" + +#: ../../page.rst:532 e49f927719bc44edb2efac39dc1b0594 +msgid "rotate the text by an arbitrary angle." +msgstr "" + +#: ../../page.rst:533 da90ba2a59094b1a8a9a92aea17a1c43 +msgid "*(new in v1.18.4)* the :data:`xref` of an :data:`OCG` or :data:`OCMD`." +msgstr "" + +#: ../../page.rst:535 c47a81babb63462b98a1e468fcc857ff +msgid "" +"Parameters *overlay, keep_proportion, rotate* and *oc* have the same " +"meaning as in :meth:`Page.show_pdf_page`." +msgstr "" + +#: ../../page.rst:556 ../../page.rst:580 ../../page.rst:601 ../../page.rst:622 +#: ../../page.rst:643 ../../page.rst:663 ../../page.rst:683 ../../page.rst:704 +#: ../../page.rst:724 ../../page.rst:745 ../../page.rst:765 ../../page.rst:786 +#: ../../page.rst:807 114d04c75ea0499e957af5c8e644ff68 +#: 129302697dda4f85a02e70eb757a7370 246e8644342343d0a88e0112cbf8d53e +#: 2542c01e3d7a42718b1e00350ce802dc 6ac31b0fa5164542aa0b40223500d536 +#: 7f21bbfcc4e549d2a4309c9bdb2a6177 7f938ad3488d4bb39e835c123d4750e7 +#: abd2afb07582439282fcb0b81dbeeb05 b1f8e5f2b2b54917bdff8ff9b1da50c9 +#: cc383c8a1434471f995c841f6166251f f1e2425776d049d4a84228651a15f3e1 +#: f4950b52cde44676a790647bc6ad16a3 fb02a76f4ddb4e3aa21dd9a322a46fcc +msgid "Changed in v1.18.4" +msgstr "" + +#: ../../page.rst:558 950637b4a32041688cf1cfd02df1f737 +msgid "" +"PDF only: Insert text starting at :data:`point_like` *point*. See " +":meth:`Shape.insert_text`." +msgstr "" + +#: ../../page.rst:582 1da22f98329a46b49295fc4c514f2990 +msgid "" +"PDF only: Insert text into the specified :data:`rect_like` *rect*. See " +":meth:`Shape.insert_textbox`." +msgstr "" + +#: ../../page.rst:603 f295342a9e5c4c94a61f6153398b855f +msgid "" +"PDF only: Draw a line from *p1* to *p2* (:data:`point_like` \\s). See " +":meth:`Shape.draw_line`." +msgstr "" + +#: ../../page.rst:624 d75b788929cb438fbd257b4662366d98 +msgid "" +"PDF only: Draw a zigzag line from *p1* to *p2* (:data:`point_like` \\s). " +"See :meth:`Shape.draw_zigzag`." +msgstr "" + +#: ../../page.rst:645 e66b9ef3e99a4756969d0c8732ebf03d +msgid "" +"PDF only: Draw a squiggly (wavy, undulated) line from *p1* to *p2* " +"(:data:`point_like` \\s). See :meth:`Shape.draw_squiggle`." +msgstr "" + +#: ../../page.rst:665 e3471c0162024d91a41b2729b6ac9f97 +msgid "" +"PDF only: Draw a circle around *center* (:data:`point_like`) with a " +"radius of *radius*. See :meth:`Shape.draw_circle`." +msgstr "" + +#: ../../page.rst:685 86c2d0c28d2e49fcb44bcde395a6edce +msgid "" +"PDF only: Draw an oval (ellipse) within the given :data:`rect_like` or " +":data:`quad_like`. See :meth:`Shape.draw_oval`." +msgstr "" + +#: ../../page.rst:706 7036ecade86944ceb3a0cd11f01405c1 +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 "" + +#: ../../page.rst:726 ea1273f78bc24ec19215c09a65ebf39e +msgid "" +"PDF only: Draw several connected lines defined by a sequence of " +":data:`point_like` \\s. See :meth:`Shape.draw_polyline`." +msgstr "" + +#: ../../page.rst:747 8c7de77eefc846418b5090d2596c4d2b +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 "" + +#: ../../page.rst:767 b886cb50a96540138b0d72ff245eb173 +msgid "" +"PDF only: This is a special case of *draw_bezier()*. See " +":meth:`Shape.draw_curve`." +msgstr "" + +#: ../../page.rst:787 4e3c87ab1c674513b5b17c45292040a0 +msgid "Changed in v1.22.0: Added parameter *radius*." +msgstr "" + +#: ../../page.rst:789 22ed6b6e87de4f22a2f0fc1607e1243f +msgid "PDF only: Draw a rectangle. See :meth:`Shape.draw_rect`." +msgstr "" + +#: ../../page.rst:809 09ab421f248e4ece83cb24cb70685870 +msgid "PDF only: Draw a quadrilateral. See :meth:`Shape.draw_quad`." +msgstr "" + +#: ../../page.rst:821 6a68ef1915ed47d7b6c8bebeebbaf5f0 +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 "" + +#: ../../page.rst:823 3e2634c3bae64aedaeee8662b3a0564a +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 "" + +#: ../../page.rst:825 cd2db768363e43f8914989e9e3613fd7 +msgid "" +"In other words, you cannot insert a font via *fontfile* / *fontbuffer* " +"and also give it a reserved *fontname*." +msgstr "" + +#: ../../page.rst:827 6627c3af904e4b81a4e47d0cd02148d7 +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 "" + +#: ../../page.rst:829 681d840384e84bb08e7af955e13abae2 +msgid "" +"a path to a font file. If used, *fontname* must be **different from all " +"reserved names**." +msgstr "" + +#: ../../page.rst:831 7210674b172b41fcbba7761f46a056fd +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 "" + +#: ../../page.rst:833 54bfdd3403194678a8011a05ae66f789 +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 "" + +#: ../../page.rst:835 376461740edb4c9ab93ad0137270b39f +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 "" + +#: ../../page.rst 7b48f96ea4534f8a82e66fea1c734ffe +msgid "rytpe" +msgstr "" + +#: ../../page.rst:837 ../../page.rst:1685 ../../page.rst:1769 +#: 2c7ae35c24fb415cabb2ff82cb9f9acd 51d8ccdf1e6d4aba8c45bc1d33c7ab72 +#: 5d74505ffb2946e4ba159546b24c34de +msgid "int" +msgstr "" + +#: ../../page.rst:838 ee3734198ea94ca388f872902edaeebd +msgid "the :data:`xref` of the installed font." +msgstr "" + +#: ../../page.rst:840 72a73208249149eb9e56d6f8277a2380 +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 "" + +#: ../../page.rst:842 74d1392a943c407094b684e408755751 +msgid "**Base-14 Fonts** [#f1]_" +msgstr "" + +#: ../../page.rst:845 ../../page.rst:866 ad45cacf505841df92fe4b59b1a6185b +#: ff7877920c384fd39f71a5126be0d4cd +msgid "**Font Name**" +msgstr "" + +#: ../../page.rst:845 ../../page.rst:866 3f0209537a114b59b4536efe4770f3b9 +#: b1bd9831282a4d0ca9be6ea24d02f28c +msgid "**Installed Base Font**" +msgstr "" + +#: ../../page.rst:845 ../../page.rst:866 3ee548353c404cefb70820686b87ec37 +#: 922d7f05a29f471b8e78c15dcc73eba8 +msgid "**Comments**" +msgstr "" + +#: ../../page.rst:847 78cc4400bb88415ca73d63b37833bc55 +msgid "helv" +msgstr "" + +#: ../../page.rst:847 be511bacb63b4326ac1e7dde877293a4 +msgid "Helvetica" +msgstr "" + +#: ../../page.rst:847 ../../page.rst:851 ../../page.rst:855 +#: 07e950c337704689ab87d80cc7f33a3c 86e12621814d43c7a92bee7e6075d6ff +#: e9ff3bff2ff74bb4b8f2efaa1fafb245 +msgid "normal" +msgstr "" + +#: ../../page.rst:848 d4ef2425fbbd40a18a936e47591c2d0f +msgid "heit" +msgstr "" + +#: ../../page.rst:848 b368f6f728a042438f1078d700290ed6 +msgid "Helvetica-Oblique" +msgstr "" + +#: ../../page.rst:848 ../../page.rst:852 ../../page.rst:856 +#: 5527daae351044c8ba2741ca5bc0ee72 a1a99f06860643a79b0520ec4d951205 +#: e2e5fa825ef6434e98fb4047bb11099d +msgid "italic" +msgstr "" + +#: ../../page.rst:849 b31ba19347814f57b1043e863bc04f1c +msgid "hebo" +msgstr "" + +#: ../../page.rst:849 d28cc182c0874efcb25c4f6125fab1b1 +msgid "Helvetica-Bold" +msgstr "" + +#: ../../page.rst:849 ../../page.rst:853 ../../page.rst:857 +#: 4b39b6ceb59a4009b525b892538dd150 ab389a33ff9547bf8ae764284627be19 +#: e4c2dbb0628a4be6b000747bcc47288b +msgid "bold" +msgstr "" + +#: ../../page.rst:850 ba4b2dcc36004ace823799b7c98d9128 +msgid "hebi" +msgstr "" + +#: ../../page.rst:850 a3f649a95a804dabbe7bf73646538632 +msgid "Helvetica-BoldOblique" +msgstr "" + +#: ../../page.rst:850 ../../page.rst:854 ../../page.rst:858 +#: 301721f06f904309bbe9a135eb2dcc93 f2850bb077ba416887a291ffcdae3570 +#: f93011f0c0cf45ffaf2b5ddbb443a26d +msgid "bold-italic" +msgstr "" + +#: ../../page.rst:851 1c940625101c4ad89e9a82430e4f9178 +msgid "cour" +msgstr "" + +#: ../../page.rst:851 6bb9f6b456024dc186d2969697372ce3 +msgid "Courier" +msgstr "" + +#: ../../page.rst:852 dd404f874bae47b88441d7534c0400be +msgid "coit" +msgstr "" + +#: ../../page.rst:852 14fa52a8156b4bd49bf73a5e1f0227bd +msgid "Courier-Oblique" +msgstr "" + +#: ../../page.rst:853 ec098535f704474f86382563b8fe8cd0 +msgid "cobo" +msgstr "" + +#: ../../page.rst:853 cff74382efe44bbf86a52dd318acdfd8 +msgid "Courier-Bold" +msgstr "" + +#: ../../page.rst:854 051edb300a6a4aedbcf6b0e6ac6d8ca3 +msgid "cobi" +msgstr "" + +#: ../../page.rst:854 0fe9930b6afc4485802953ea19f34cf0 +msgid "Courier-BoldOblique" +msgstr "" + +#: ../../page.rst:855 3cab3d915059400cbcfb769e8a8c809a +msgid "tiro" +msgstr "" + +#: ../../page.rst:855 0ad970d4606447afa924d780a1ea0382 +msgid "Times-Roman" +msgstr "" + +#: ../../page.rst:856 24dd2a6e0e984c578d36b068db4fb074 +msgid "tiit" +msgstr "" + +#: ../../page.rst:856 16b2bdd1ea7048f8b4b75b3b68667e26 +msgid "Times-Italic" +msgstr "" + +#: ../../page.rst:857 7f66f82124114034b6830dd51ecfc3ef +msgid "tibo" +msgstr "" + +#: ../../page.rst:857 d46801929cc4495bb3bf514a0aa45975 +msgid "Times-Bold" +msgstr "" + +#: ../../page.rst:858 ae79135985234e1c9d22393e89d3e55d +msgid "tibi" +msgstr "" + +#: ../../page.rst:858 138b6816ae514092aae23f07db5880a4 +msgid "Times-BoldItalic" +msgstr "" + +#: ../../page.rst:859 8311fbcd1639439ca737b4be5686012b +msgid "symb" +msgstr "" + +#: ../../page.rst:859 308b75a7675146469d8e35c591460d82 +msgid "Symbol" +msgstr "" + +#: ../../page.rst:859 ../../page.rst:860 515c511f8b1a4fa3b85218079b863fec +#: 5f8954ca2c324c619532d6c00a6e1fa2 +msgid "[#f3]_" +msgstr "" + +#: ../../page.rst:860 2892a14ce5ed4b48bf8b1395b7ba1a12 +msgid "zadb" +msgstr "" + +#: ../../page.rst:860 631350e311c14d71bdddaea830b8a3c2 +msgid "ZapfDingbats" +msgstr "" + +#: ../../page.rst:863 8977d47ffb5541668299623936a50032 +msgid "**CJK Fonts** [#f2]_ (China, Japan, Korea)" +msgstr "" + +#: ../../page.rst:868 370513f2d3f145648ab346718a4ce464 +msgid "china-s" +msgstr "" + +#: ../../page.rst:868 f0f7488930f948179faec55f250b4fd1 +msgid "Heiti" +msgstr "" + +#: ../../page.rst:868 994915560fc24c289c2985341a54c5b3 +msgid "simplified Chinese" +msgstr "" + +#: ../../page.rst:869 225e9ad164834b858b1a4b1ceee0b56f +msgid "china-ss" +msgstr "" + +#: ../../page.rst:869 1aaba4c26cf24074ad7ddbd787c327cb +msgid "Song" +msgstr "" + +#: ../../page.rst:869 8e9e355bda48424c8fdcc1c32c95bbec +msgid "simplified Chinese (serif)" +msgstr "" + +#: ../../page.rst:870 4ad6e04dae85445d87f494e35f7fff91 +msgid "china-t" +msgstr "" + +#: ../../page.rst:870 3181ab89fc1a44c7ba8838a56fb0d056 +msgid "Fangti" +msgstr "" + +#: ../../page.rst:870 1fdfcf2b83e647598ea492943458c6cd +msgid "traditional Chinese" +msgstr "" + +#: ../../page.rst:871 537c4d5b47124adf8ac58897964c3d67 +msgid "china-ts" +msgstr "" + +#: ../../page.rst:871 7493f320c95c4d0680f88073754acd64 +msgid "Ming" +msgstr "" + +#: ../../page.rst:871 84bb9a9780ca4edfbc80d2544d25f654 +msgid "traditional Chinese (serif)" +msgstr "" + +#: ../../page.rst:872 a295373ebbf34a76807234e54932d1a0 +msgid "japan" +msgstr "" + +#: ../../page.rst:872 589aaf9dfce34c6badb4527ec4057246 +msgid "Gothic" +msgstr "" + +#: ../../page.rst:872 d7698b9f8afe4778acdc0f6091906025 +msgid "Japanese" +msgstr "" + +#: ../../page.rst:873 15573d9154414182b73374bd731f7ac5 +msgid "japan-s" +msgstr "" + +#: ../../page.rst:873 36928f1d246f4b74ab168ac51db4d1f7 +msgid "Mincho" +msgstr "" + +#: ../../page.rst:873 b746e9096fd84441a6737d81e4386925 +msgid "Japanese (serif)" +msgstr "" + +#: ../../page.rst:874 9adc3a834f494231bc681ce146bed104 +msgid "korea" +msgstr "" + +#: ../../page.rst:874 85c5e88403514ec58f80bdddb4ed688a +msgid "Dotum" +msgstr "" + +#: ../../page.rst:874 d5a7483efeaa4fb18f7966b5f6592cd6 +msgid "Korean" +msgstr "" + +#: ../../page.rst:875 25924d37a3eb4b9391eb978249959ebb +msgid "korea-s" +msgstr "" + +#: ../../page.rst:875 2f8b65341bf24e65837a17b3be8abd8a +msgid "Batang" +msgstr "" + +#: ../../page.rst:875 ed1cfb6d0e144c70b8991b45a253c8b8 +msgid "Korean (serif)" +msgstr "" + +#: ../../page.rst:891 b93513cf36c64f8baa7844eb648e5244 +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 "" + +#: ../../page.rst:893 bb6ed58a098e49f6bd63f6ef0ec9b0a6 +msgid "Changed in v1.14.1: By default, the image keeps its aspect ratio." +msgstr "" + +#: ../../page.rst:894 65e739804b1e46589a4ca8bc58c17e75 +msgid "" +"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." +msgstr "" + +#: ../../page.rst:895 71d3945b59ad4f9c9f9748f3e1131921 +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 "" + +#: ../../page.rst:896 597ec9dc17b24be78d731b565038c112 +msgid "" +"Changed in v1.18.13: Allow providing the image as the xref of an existing" +" one." +msgstr "" + +#: ../../page.rst:898 af63491513e64fe0a9e2e5da1a8cd6e7 +msgid "where to put the image. Must be finite and not empty." +msgstr "" + +#: ../../page.rst:899 dfceb440309b4393b3f29fbf9e9e7428 +msgid "" +"name of an image file (all formats supported by MuPDF -- see " +":ref:`ImageFiles`)." +msgstr "" + +#: ../../page.rst:900 96ebc2a78656499cba634d08b286f8db +msgid "" +"image in memory (all formats supported by MuPDF -- see " +":ref:`ImageFiles`). Changed in v1.14.13: *io.BytesIO* is now also " +"supported." +msgstr "" + +#: ../../page.rst:900 b70bbbe68796427aa884b758b144099c +msgid "image in memory (all formats supported by MuPDF -- see :ref:`ImageFiles`)." +msgstr "" + +#: ../../page.rst:902 746335b0ce164cf3bdaedba30b771300 +msgid "Changed in v1.14.13: *io.BytesIO* is now also supported." +msgstr "" + +#: ../../page.rst:904 b801019301984a6ab1fc9849462ae947 +msgid "a pixmap containing the image." +msgstr "" + +#: ../../page.rst:907 92c35b3fc60c4a98ac6591e1d398c034 +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 "" + +#: ../../page.rst:909 0a612c9a713740d5ad503c87baa994b5 +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 "" + +#: ../../page.rst:911 8ee1ddf7108247a8aab892eca0d74de8 +msgid "*(Changed in v1.19.3)* deprecated. No longer needed -- ignored when given." +msgstr "" + +#: ../../page.rst:913 20a54ae82e9d425da6ef7faff3740b76 +msgid "" +"*(new in version v1.14.11)* 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 "" + +#: ../../page.rst:921 6ff770bdef8d4c038d627bc90336f0cd +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 "" + +#: ../../page.rst:922 3d227b97e6484a10bb31619029aa7d2a +msgid "*(new in version v1.14.11)* maintain the aspect ratio of the image." +msgstr "" + +#: ../../page.rst:924 f4c8d6966a2b4a708e830a33ec9288cd +msgid "For a description of *overlay* see :ref:`CommonParms`." +msgstr "" + +#: ../../page.rst:926 1f08b3447d8549658bb7913e2ca84483 +msgid "*Changed in v1.18.13:* Return xref of stored image." +msgstr "" + +#: ../../page.rst:929 a42a29307b2b40d5b75a4b3f2d5ff9f4 +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 "" + +#: ../../page.rst:931 555a857bb2bf42f89615cd1de42ce7bf +msgid "This example puts the same image on every page of a document::" +msgstr "" + +#: ../../page.rst:945 427e0c2a9512404cae2dadefc3c8500a +msgid "" +"The method detects multiple insertions of the same image (like in 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 "" + +#: ../../page.rst:947 0d2fb024302d4643a4d3ed1976acd364 +msgid "" +"The method cannot detect if the same image had already been part of the " +"file before opening it." +msgstr "" + +#: ../../page.rst:949 52b2ba0bfb9f4faf8e50a5de7a683f88 +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:951 daa7fc94769347649a7a713c027bafd4 +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 exist effective ways to control " +"the image size -- even if transparency comes into play. Have a look at " +"`this `_ section of the documentation." +msgstr "" + +#: ../../page.rst:953 ec06cdffce77422dacb1edff33a03139 +msgid "" +"The image is stored in the PDF in its original quality. This may be much " +"better than what you ever 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 "" + +#: ../../page.rst:955 a77ada16df804aaa99e0b882d46b0f98 +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. Demo script `fitz-logo.py " +"`_ implements a fairly complete approach." +msgstr "" + +#: ../../page.rst:966 ../../page.rst:987 c4e260d6752f4f0f8f3601b6a8517470 +#: fcc2363c17bd41e8a90ef269b0f75072 +msgid "New in v1.21.0" +msgstr "" + +#: ../../page.rst:968 15d8b0af8f2646e482b8e69fb5701ac6 +msgid "Replace the image at xref with another one." +msgstr "" + +#: ../../page.rst:970 ../../page.rst:991 0e408fab46d54805984e704ae31835fe +#: 60b63372e7044c0cb5a69c0619aed29f +msgid "the :data:`xref` of the image." +msgstr "" + +#: ../../page.rst:971 5d9a4e22495445aa9c04c20d7c79ff01 +msgid "the filename of the new image." +msgstr "" + +#: ../../page.rst:972 d511976bba744f41a49c94585d91fe7d +msgid "the :ref:`Pixmap` of the new image." +msgstr "" + +#: ../../page.rst:973 d6b761655870480ebeda6eae377b55ee +msgid "the memory area containing the new image." +msgstr "" + +#: ../../page.rst:975 080531abda0d41df962f5b62778411a6 +msgid "" +"Arguments `filename`, `pixmap`, `stream` have the same meaning as in " +":meth:`Page.insert_image`, especially exactly one of these must be " +"provided." +msgstr "" + +#: ../../page.rst:977 555b89cf61ac49fd95bca401885ea240 +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:979 3f2a46430d0d40d78a82d13aa3601cf2 +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:989 fb3cbaa5b7a04a54896e91a5a04f2941 +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 "" + +#: ../../page.rst:993 69d1bcdd8e85404abc667d067eb15ebb +msgid "" +"This is a **global replacement:** the image will disappear wherever the " +"old one has been displayed throughout the file." +msgstr "" + +#: ../../page.rst:995 135a31c981a34a9d9ddaf5816dcbaa6c +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 "" + +#: ../../page.rst:1019 559c6b1d6d534bb3bf831d253da85de8 +msgid "Changed in v1.19.0: added `textpage` parameter" +msgstr "" + +#: ../../page.rst:1020 6aa3472763604fcf88e05727607a3d1d +msgid "Changed in v1.19.1: added `sort` parameter" +msgstr "" + +#: ../../page.rst:1021 c092a8a4fd244711946961f211f58183 +msgid "" +"Changed in v1.19.6: added new constants for defining default flags per " +"method." +msgstr "" + +#: ../../page.rst:1023 eb21e1e7d5ab442ca845788a8130d7dc +msgid "" +"Retrieves the content of a page in a variety of formats. This is a " +"wrapper for :ref:`TextPage` methods by choosing the output option as " +"follows:" +msgstr "" + +#: ../../page.rst:1025 bb71200a14fa4c10abd4db30b99d1a9f +msgid "\"text\" -- :meth:`TextPage.extractTEXT`, default" +msgstr "" + +#: ../../page.rst:1026 e58dca9d22a24cc48729e3133be4f9c9 +msgid "\"blocks\" -- :meth:`TextPage.extractBLOCKS`" +msgstr "" + +#: ../../page.rst:1027 bbaef12143a24d719fd45be8aa1eac2b +msgid "\"words\" -- :meth:`TextPage.extractWORDS`" +msgstr "" + +#: ../../page.rst:1028 5a706a4129614d90b67ecdbc65620a72 +msgid "\"html\" -- :meth:`TextPage.extractHTML`" +msgstr "" + +#: ../../page.rst:1029 dba1a79422c44f6d8a95b80f8a40bfe2 +msgid "\"xhtml\" -- :meth:`TextPage.extractXHTML`" +msgstr "" + +#: ../../page.rst:1030 345ddb6539d147c38f2b0c3d2378aa60 +msgid "\"xml\" -- :meth:`TextPage.extractXML`" +msgstr "" + +#: ../../page.rst:1031 9a29d4cad78844b1bc89e6d59ab0a27b +msgid "\"dict\" -- :meth:`TextPage.extractDICT`" +msgstr "" + +#: ../../page.rst:1032 551a55bb84234cfbaf0427226418eb7c +msgid "\"json\" -- :meth:`TextPage.extractJSON`" +msgstr "" + +#: ../../page.rst:1033 29a00f33f6654c66b6757a7a2ca4ef9f +msgid "\"rawdict\" -- :meth:`TextPage.extractRAWDICT`" +msgstr "" + +#: ../../page.rst:1034 a7d66734fb0b4688b97dac331062eb43 +msgid "\"rawjson\" -- :meth:`TextPage.extractRAWJSON`" +msgstr "" + +#: ../../page.rst:1036 f9820beb3408468ea92da28e066b4e0c +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 "" + +#: ../../page.rst:1036 bd0926d6a336463191c5a2fafa9a84d5 +msgid "" +"A string indicating the requested format, one of the above. A mixture of " +"upper and lower case is supported." +msgstr "" + +#: ../../page.rst:1038 9d6a3b583a004f28a5974bb2ed107813 +msgid "Changed in v1.16.3 Values \"words\" and \"blocks\" are now also accepted." +msgstr "" + +#: ../../page.rst:1040 3b686fd7998241e09c9f46a9a590ff86 +msgid "" +"*(new in v1.17.7)* restrict extracted text to this rectangle. If None, " +"the full page is taken. Has **no effect** for options \"html\", \"xhtml\"" +" and \"xml\"." +msgstr "" + +#: ../../page.rst:1042 c1c3a0fed25a458fb92b9195c3ed13f7 +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 "" + +#: ../../page.rst:1044 0e30ab894f284c3b954623e86e41b256 +msgid "" +"(new in v1.19.0) 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 "" + +#: ../../page.rst:1046 0c53b8665f134d0bb8bf609b3a28f350 +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 "" + +#: ../../page.rst:1048 7df6cb1c7b074a8d9100b68728b968fb +msgid "*str, list, dict*" +msgstr "" + +#: ../../page.rst:1049 c0bbe8e399684e53a0325a6746febffd +msgid "" +"The page's content as a string, a list or a dictionary. Refer to the " +"corresponding :ref:`TextPage` method for details." +msgstr "" + +#: ../../page.rst:1053 3b5c581b2ffe4888b7b9f23e0b5d323f +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 "" + +#: ../../page.rst:1054 bf4d2fd80181438da9fc7fd4637d7077 +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 "" + +#: ../../page.rst:1062 24c09918842649f391cb93e20d839381 +msgid "New in v1.17.7" +msgstr "" + +#: ../../page.rst:1063 bbda0eab14a14792a8c868f69fd9b692 +msgid "Changed in v1.19.0: add `textpage` parameter" +msgstr "" + +#: ../../page.rst:1065 d5909d5f5951455bb49a7c94a9edbf7c +msgid "Retrieve the text contained in a rectangle." +msgstr "" + +#: ../../page.rst:1067 9a732c982cd64f29b398d39f55242072 +msgid "rect-like." +msgstr "" + +#: ../../page.rst:1068 ec9f7d20d20d4b77958f268a48b2e8ae +msgid "" +"a :ref:`TextPage` to use. If omitted, a new, temporary textpage will be " +"created." +msgstr "" + +#: ../../page.rst:1070 f56d160a55ed4fcba4743c3e0e31e8af +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 "" + +#: ../../page.rst:1070 8480dc27ee0e47b3a00f29aa5b4e7b27 +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`:" +msgstr "" + +#: ../../page.rst:1084 3aeccfcf1ca343eaab601ac2f41ac786 +msgid "New in v1.16.5" +msgstr "" + +#: ../../page.rst:1085 cb5209ff3aa84c2e934a46581f1a6426 +msgid "Changed in v1.17.7: introduced `clip` parameter." +msgstr "" + +#: ../../page.rst:1087 8ca270f9b8de4167ad0dc8d73b4804c9 +msgid "Create a :ref:`TextPage` for the page." +msgstr "" + +#: ../../page.rst:1089 38d6e0a4d4704a7086b00fdb02d268c3 +msgid "" +"indicator bits controlling the content available for subsequent text " +"extractions and searches -- see the parameter of :meth:`Page.get_text`." +msgstr "" + +#: ../../page.rst:1091 d991caf5265d43a6afdfaee448b701fd +msgid "*(new in v1.17.7)* restrict extracted text to this area." +msgstr "" + +#: ../../page.rst:1093 0ab87104a2b84ffa91dd46fde745dc39 +msgid ":ref:`TextPage`" +msgstr "" + +#: ../../page.rst:1105 501c07f8a77c49a5bc2ef59a736afa13 +msgid "New in v.1.19.0" +msgstr "" + +#: ../../page.rst:1106 42caf4309056477087e99f7da3d0ff43 +msgid "Changed in v1.19.1: support full and partial OCRing a page." +msgstr "" + +#: ../../page.rst:1108 6ee9764b5c3146c3bdaca2d8c5ee6d76 +msgid "" +"Create 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 "" + +#: ../../page.rst:1110 46f0a002198c4bbeba49b987ee9fec19 +msgid "" +"indicator bits controlling the content available for subsequent test " +"extractions and searches -- see the parameter of :meth:`Page.get_text`." +msgstr "" + +#: ../../page.rst:1111 fd106e97114642a78efd67c37f5b4468 +msgid "" +"the expected language(s). Use \"+\"-separated values if multiple " +"languages are expected, \"eng+spa\" for English and Spanish." +msgstr "" + +#: ../../page.rst:1112 543404c44ebb4e8583e2b7d57dee5a3c +msgid "" +"the desired resolution in dots per inch. Influences recognition quality " +"(and execution time)." +msgstr "" + +#: ../../page.rst:1113 4d4b1a75d43a45e2a8dda656e5ae66f1 +msgid "whether to OCR the full page, or just the displayed images." +msgstr "" + +#: ../../page.rst:1114 553121eca84b4b5d903528f08cccd9eb +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 "" + +#: ../../page.rst:1116 a9b251e5b40c40e9a606eba79fca4389 +msgid "" +"This method does **not** support a clip parameter -- OCR will always " +"happen for the complete page rectangle." +msgstr "" + +#: ../../page.rst:1118 c3b2be08624548b5a9955ad5ed41eefb +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:1120 01a955eee4974c16bfa16213e1fdf017 +msgid "" +"a :ref:`TextPage`. Execution may be significantly longer than " +":meth:`Page.get_textpage`." +msgstr "" + +#: ../../page.rst:1122 d38b4d1bd8da449abf733d6be44f8d06 +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 "" + +#: ../../page.rst:1126 52a35720931a4ab7a8e09f4be6915f17 +msgid "" +"**OCRed text is only available** to PyMuPDF's text extractions and " +"searches if their `textpage` parameter specifies the output of this " +"method." +msgstr "" + +#: ../../page.rst:1128 32021611b4d34951ae646714eb1d78d4 +msgid "" +"`This `_ Jupyter notebook walks through an example " +"for using OCR textpages." +msgstr "" + +#: ../../page.rst:1133 ba44c21dcdb641489f754d2b0328ab0e +msgid "New in v1.18.0" +msgstr "" + +#: ../../page.rst:1134 0d3cf4d0dc054b3aabd67eea384dd689 +msgid "Changed in v1.18.17" +msgstr "" + +#: ../../page.rst:1135 d818b22a5a4b4502bd2300e1145a1030 +msgid "Changed in v1.19.0: add \"seqno\" key, remove \"clippings\" key" +msgstr "" + +#: ../../page.rst:1136 f82625e599c143aaa85c24dabaa317f7 +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 "" + +#: ../../page.rst:1137 be1dab904b5b4c0dbe3d27dc6bc33273 +msgid "" +"Changed in v1.19.2: add an indicator for the *\"orientation\"* of the " +"area covered by an \"re\" item." +msgstr "" + +#: ../../page.rst:1138 0f9bddd422d8438b8bd77850c92de14e +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 "" + +#: ../../page.rst:1139 121c28be5d654643a0f31778854ffebf +msgid "" +"Changed in v1.22.0: add parameter `extended` to also return clipping and " +"group paths." +msgstr "" + +#: ../../page.rst:1141 06f23a6a613543dc8374f144c6e7e5e9 +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:1143 423f6395d66f415791c3f6eefac5d725 +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 "" + +#: ../../page.rst:1145 6992d6f6885a4a00b92675d7fe4e3508 +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 "" + +#: ../../page.rst:1148 ../../page.rst:1213 ../../page.rst:1228 +#: 17528eae1b6e45c9a0b1effc5b8d2e4f 267d8caa049142899d55fed8df3bdab4 +#: 3db12d98cd544269bf586f24b942e5f1 +msgid "Key" +msgstr "" + +#: ../../page.rst:1148 ../../page.rst:1213 ../../page.rst:1228 +#: 30a39a06f6944f81942145c66d6fb9bc 74b0a9fb604248eebf3899f28a43c4a3 +#: 8457381b04b2447f9967f12f3c7a380a +msgid "Value" +msgstr "" + +#: ../../page.rst:1150 ../../page.rst:1215 9bab75906ef143cea6d438bafe57aa60 +#: fa8aefb55acc4fb69794e0f794afb1da +msgid "closePath" +msgstr "" + +#: ../../page.rst:1150 ../../page.rst:1157 8e8c993e3b9e4ecb85f3de297a726654 +#: fdc5363ee5264b088a219fdd92051439 +msgid "Same as the parameter in :ref:`Shape`." +msgstr "" + +#: ../../page.rst:1151 b1f8214e99134ab29fe617022dbd81ee +msgid "color" +msgstr "" + +#: ../../page.rst:1151 1e24cce7904e486c86b80301e21a6b6f +msgid "Stroke color (see :ref:`Shape`)." +msgstr "" + +#: ../../page.rst:1152 ef2a5c4536f94b27a5b49d93e1ed6ae8 +msgid "dashes" +msgstr "" + +#: ../../page.rst:1152 441bca32c047468c98691331d93a2d26 +msgid "Dashed line specification (see :ref:`Shape`)." +msgstr "" + +#: ../../page.rst:1153 ../../page.rst:1216 c1dd3acb6c8c4c2db62f50d20fd79dd8 +#: fe5ac4401f2b48c1aca405893944fe9d +msgid "even_odd" +msgstr "" + +#: ../../page.rst:1153 ab1dea73180d442793973a6fd3f62c63 +msgid "Fill colors of area overlaps -- same as the parameter in :ref:`Shape`." +msgstr "" + +#: ../../page.rst:1154 82db03a63d79478082657974e9fedf90 +msgid "fill" +msgstr "" + +#: ../../page.rst:1154 d0b49d586b8c4e0c962fc65599ad1985 +msgid "Fill color (see :ref:`Shape`)." +msgstr "" + +#: ../../page.rst:1155 ../../page.rst:1217 7288b505637345a8b8d9cd901b21c105 +#: e0214dac98e74f9282a0c21e81de7bac +msgid "items" +msgstr "" + +#: ../../page.rst:1155 012ed624099a40c19ddfbf091514fea9 +msgid "List of draw commands: lines, rectangles, quads or curves." +msgstr "" + +#: ../../page.rst:1156 160bef43cc6d462eb8a2bb686dfbb00d +msgid "lineCap" +msgstr "" + +#: ../../page.rst:1156 95772eede84f4371bced2c9e285ef296 +msgid "Number 3-tuple, use its max value on output with :ref:`Shape`." +msgstr "" + +#: ../../page.rst:1157 d1f78499fded4874aa6daf1ccd3538cb +msgid "lineJoin" +msgstr "" + +#: ../../page.rst:1158 d8f3c4a057f94d9983f53f7f7269fb34 +msgid "fill_opacity" +msgstr "" + +#: ../../page.rst:1158 b2ea819b98e8470db3b56dcecc2ec387 +msgid "(new in v1.18.17) fill color transparency (see :ref:`Shape`)." +msgstr "" + +#: ../../page.rst:1159 4ebde2a67e1143e3b016b57588abbc6a +msgid "stroke_opacity" +msgstr "" + +#: ../../page.rst:1159 d76b3e18fdc246c3ba80826280510557 +msgid "(new in v1.18.17) stroke color transparency (see :ref:`Shape`)." +msgstr "" + +#: ../../page.rst:1160 ../../page.rst:1218 ../../page.rst:1230 +#: 0ce3f6d042694e568e86d1ecb9dc1d4e b7c3116c13924db9a093d795c48996e7 +#: c71c95ae40fb46909b25ded75fe6ffa2 +msgid "rect" +msgstr "" + +#: ../../page.rst:1160 6baece42a99c47dda0fa7f0ae0cec21e +msgid "Page area covered by this path. Information only." +msgstr "" + +#: ../../page.rst:1161 ../../page.rst:1219 ../../page.rst:1231 +#: c09b1a690d1e419594fa2bf06aead621 c87ca063f60a44358f8dacb1438c1cb1 +#: f3e1bfb46f93489399b653ad0345aa9f +msgid "layer" +msgstr "" + +#: ../../page.rst:1161 de74666df93b4114a4b04ec98f8dc78d +msgid "(new in v1.22.0) name of applicable Optional Content Group" +msgstr "" + +#: ../../page.rst:1162 ../../page.rst:1220 ../../page.rst:1232 +#: 1350ce70b71a4d6491f306921412632d 2d105ea7f48f41a79b5d69ffb97cf669 +#: 49edf7b1b7d64c9d8b0044bd5f1a9d32 +msgid "level" +msgstr "" + +#: ../../page.rst:1162 23ff72d652224e88b732f8390def4665 +msgid "(new in v1.22.0) the hierarchy level if `extended=True`" +msgstr "" + +#: ../../page.rst:1163 5a82d5f0d74e415d8ceb83895f34233c +msgid "seqno" +msgstr "" + +#: ../../page.rst:1163 379a27ebb15f465f94c147ca36df3515 +msgid "(new in v1.19.0) command number when building page appearance" +msgstr "" + +#: ../../page.rst ../../page.rst:1164 ../../page.rst:1222 ../../page.rst:1237 +#: 0620f6ea941e4a47897179e7ac075565 0b11dcafac5249679440457dd4086d24 +#: 2b2ca7c294ca4614a86cc5b8e8df85df 2f1d2d0051884666a62524f2576b84cf +#: 33dfe2f6a20d453ebf9e640614eafcf6 4557edb9e1f949d2b2f9b884f217586c +#: 516c067757f1409485c48cf00cd07444 5beca2d266dc4587b18a1c5495da2cb2 +#: 6f93d7da7aa74c3faa5ae6c438e896a1 75194b6a0efe4cb9b765cdd99cab1072 +#: 775dff40dffe4cbfb95e8f6755e7dc29 902f7441375a4a02a2bccfc314120f5f +#: be18c05e34dc4bdbba81ac5baceb8b68 c0d9638646644d0282613e2b154c631d +#: c70938c503124bce94f2da275565f02a cf8d29520663402d91baad352cc30786 +#: d16c9215dc504efe916a2a60b9fb24e0 ec354257880c4ccfa5299ddf992b4147 +msgid "type" +msgstr "" + +#: ../../page.rst:1164 3e6f5956d0bf414282a83cc395eb53c2 +msgid "(new in v1.18.17) type of this path." +msgstr "" + +#: ../../page.rst:1165 ../../page.rst:1316 304bba7f5e804f0987c5ea45dcbfcf9b +#: 504e2044e7e74e648dd474698dd66b04 +msgid "width" +msgstr "" + +#: ../../page.rst:1165 3624f4bde3724f5592abee7334d7b69e +msgid "Stroke line width (see :ref:`Shape`)." +msgstr "" + +#: ../../page.rst:1168 ../../page.rst:1242 09d8a697eb384b039af6e30f0e72e2b4 +#: 95bc43c8017947238e38ff6d94968579 +msgid "" +"*(Changed in v1.18.17)* 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`." +msgstr "" + +#: ../../page.rst:1171 b5baaaa8f73f4e22afbbabc5df0fc0c8 +msgid "" +"For paths other than groups or clips, key `\"type\"` takes one of the " +"following values:" +msgstr "" + +#: ../../page.rst:1173 effaf411e3f347de89bf2e9d8a12b4a5 +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 "" + +#: ../../page.rst:1174 cafa4da4f9954847b81019ed1518f965 +msgid "" +"**\"s\"** -- this is a *stroke-only* path. Similar to previous, key " +"`\"fill\"` is present with value *None*." +msgstr "" + +#: ../../page.rst:1175 ../../page.rst:1249 437c41a4d1004b3c9fd011f512e38dc3 +#: c07f03a7494c45c4b23536d888b063f4 +msgid "" +"**\"fs\"** -- this is a path performing combined *fill* and *stroke* " +"operations." +msgstr "" + +#: ../../page.rst:1177 ../../page.rst:1251 156fcb0cee0c4259830a7d693a88a78f +#: 9385ffdfad24409a8b8afad94938100c +msgid "Each item in `path[\"items\"]` is one of the following:" +msgstr "" + +#: ../../page.rst:1179 ../../page.rst:1253 4f6f418d12414d21a95c6e941df2084d +#: b20c9b551bbd4d09b35762b9760e89f0 +msgid "`(\"l\", p1, p2)` - a line from p1 to p2 (:ref:`Point` objects)." +msgstr "" + +#: ../../page.rst:1180 ../../page.rst:1254 81fb9cdaaa094e9690ed8bf49a583848 +#: c9c1f732520b4adeb7c0dc2321118571 +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 "" + +#: ../../page.rst:1181 ../../page.rst:1255 7799ef6fe98d4266a70e761c3c19110f +#: 973d24f8ecc84138b71e2e0e03a4e04f +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 "" + +#: ../../page.rst:1182 ../../page.rst:1256 e19e6dac0c0345ac896fa7a3ca468f05 +#: ed54a702d8de4127ad8895f5c43c3323 +msgid "" +"`(\"qu\", quad)` - a :ref:`Quad`. *New in v1.18.17, changed in v1.19.2:* " +"3 or 4 consecutive lines are detected to actually represent a " +":ref:`Quad`." +msgstr "" + +#: ../../page.rst:1184 ../../page.rst:1258 8f9e60590cf545ecadbc8260b8c8bce1 +#: 9d165f5cb594460e8c3c5e43dc620d68 +msgid "" +"Starting with v1.19.2, quads and rectangles are more reliably recognized " +"as such." +msgstr "" + +#: ../../page.rst:1186 577c4319977d437fbc6e8cd6b81fc1fc +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 \"Extractings " +"Drawings\" of chapter :ref:`FAQ`." +msgstr "" + +#: ../../page.rst:1188 0927241e2693422aae3c49bb0aa1e057 +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 "" + +#: ../../page.rst:1190 23e0fb4971fc46d8b9f568272271737e +msgid "" +"Any path with a smaller level value than its predecessor will end the " +"scope of (at least) the preceeding 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 "" + +#: ../../page.rst:1206 7590fd93b4f44179965fcf95fbcab231 +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 "" + +#: ../../page.rst:1208 31980a90795c448b8f6fdb1d0b68ebcd +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 "" + +#: ../../page.rst:1210 0bf733b47fee4e7db50f30aaffc47edc +msgid "" +"**\"clip\"** dictionary. Its values (most importantly \"scissor\") remain" +" valid / apply as long as following dictionaries have a **larger " +"\"level\"** value." +msgstr "" + +#: ../../page.rst:1215 ../../page.rst:1216 ../../page.rst:1217 +#: ../../page.rst:1218 ../../page.rst:1219 ../../page.rst:1220 +#: ../../page.rst:1230 ../../page.rst:1231 ../../page.rst:1232 +#: 466456abe6b64baf9e90ef855ebebfb5 52af4bb2bd744295923ed3fffc2f8d89 +#: 848273b59d644bfbb40ea0342401f9cd 99b07f1e92894eecb2d34909360413c4 +#: a6665849a5d246d8a54f123ecf4fdf1e c4fcfc11d43d4f4585acf0b282df0e8c +#: d2ee9fd8d65a45ddae20b2edc5a33bb2 e1f207f8a6a84795a27012ea9bcead8d +#: e4c48f58663d4972a278f590bc2229f6 +msgid "Same as in \"stroke\" or \"fill\" dictionaries" +msgstr "" + +#: ../../page.rst:1221 ce14b75c68b84bce895a967813c6a547 +msgid "scissor" +msgstr "" + +#: ../../page.rst:1221 5d48bc782eec4ef18bc9fef54e249651 +msgid "the clip rectangle" +msgstr "" + +#: ../../page.rst:1222 5d715f5a19ed44648b90f53ec543083e +msgid "\"clip\"" +msgstr "" + +#: ../../page.rst:1225 bcef0f6649db46c9b8928f84dfb4b2b6 +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 "" + +#: ../../page.rst:1233 149269c33f174a6c9c4273a9689c4719 +msgid "isolated" +msgstr "" + +#: ../../page.rst:1233 db197c7f14864034b0f4d94eef94e569 +msgid "(bool) Whether this group is isolated" +msgstr "" + +#: ../../page.rst:1234 7cd39bf8618443ecb3536f9cac453513 +msgid "knockout" +msgstr "" + +#: ../../page.rst:1234 ce7d1f3a2f2e45acb1ae52d59adcbf5e +msgid "(bool) Whether this is a \"Knockout Group\"" +msgstr "" + +#: ../../page.rst:1235 efe3bd65f79743f6a2cc4f37aa1b3fed +msgid "blendmode" +msgstr "" + +#: ../../page.rst:1235 4c89498b8f2341fe94e82652c11098d4 +msgid "Name of the BlendMode, default is \"Normal\"" +msgstr "" + +#: ../../page.rst:1236 7bb9d21ff94f48b080cf6eec9161dcf4 +msgid "opacity" +msgstr "" + +#: ../../page.rst:1236 aa0b6e4410e748979873c226ddbffd62 +msgid "Float value in range [0, 1]." +msgstr "" + +#: ../../page.rst:1237 15c77d07f5ea4492a778b599ee4c4ed0 +msgid "\"group\"" +msgstr "" + +#: ../../page.rst:1245 731d1c81a310410c9b49a8ce21a09b85 +msgid "Key `\"type\"` takes one of the following values:" +msgstr "" + +#: ../../page.rst:1247 c2534d8586b64b429a1dc87879841a26 +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 "" + +#: ../../page.rst:1248 5f9abfb087124a80ab02743359be28d2 +msgid "" +"**\"s\"** -- this is a *stroke-only* path. Similar to previous, key " +"`\"fill\"` is present with value `None`." +msgstr "" + +#: ../../page.rst:1260 360616076bd04f8091940fc38896f0fe +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 "" + +#: ../../page.rst:1263 2917628c9582419f971ad072fb603648 +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 "" + +#: ../../page.rst:1269 03ff5d85e08348f3940aa4f032ee6cbd +msgid "New in v1.18.17" +msgstr "" + +#: ../../page.rst:1270 12ef7deb8dd24ead962f90f5ad897803 +msgid "Changed in v1.19.0: removed \"clippings\" key, added \"seqno\" key." +msgstr "" + +#: ../../page.rst:1271 880357122af74f98bd11a5245abf5dd1 +msgid "Changed in v1.19.1: always generate RGB color tuples." +msgstr "" + +#: ../../page.rst:1272 49261729d1874e4dbc7c753816014c27 +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 "" + +#: ../../page.rst:1273 7277cb451dd2429aa2e7b38080ee5e9a +msgid "" +"Changed in v1.22.0 added parameter `extended` to also return clipping " +"paths." +msgstr "" + +#: ../../page.rst:1275 708e382d612c430c9dca8b2e617a999f +msgid "" +"Extract the vector graphics on the page. Apart from following technical " +"differences, functionally equivalent to :meth:`Page.get_drawings`, but " +"much faster:" +msgstr "" + +#: ../../page.rst:1277 50902978ea7e42799387ef807e0d5a80 +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 "" + +#: ../../page.rst:1278 ba3750ca178f4e0284443219d39af690 +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 "" + +#: ../../page.rst:1280 f3ef030ccac14fc6950505e5e08a4473 +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 "" + +#: ../../page.rst:1285 67a4d60608634f899fb9a06f1444c6f1 +msgid "" +"PDF only: Return a list of fonts referenced by the page. Wrapper for " +":meth:`Document.get_page_fonts`." +msgstr "" + +#: ../../page.rst:1290 06468b34834d4f15a76405dbe417285d +msgid "" +"PDF only: Return a list of images referenced by the page. Wrapper for " +":meth:`Document.get_page_images`." +msgstr "" + +#: ../../page.rst:1299 209289aadf4c4b6c890b8e75fb47d372 +msgid "*New in v1.18.11*" +msgstr "" + +#: ../../page.rst:1300 82cd4aa8774b47ca8a37f389f0362472 +msgid "" +"*Changed in v1.18.13:* added image MD5 hashcode computation and " +":data:`xref` search." +msgstr "" + +#: ../../page.rst:1302 b08ab1c891d54fe4a0f00ec1a82c2c3b +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 "" + +#: ../../page.rst:1304 5db870aa56884170b95b595c94f462f1 +msgid "" +"*New in v1.18.13:* 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." +msgstr "" + +#: ../../page.rst:1306 ee7a2f542cb949f1aa78d5c5b906fd6f +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 "" + +#: ../../page.rst:1309 557e16abae1741edb9cf9530057959f0 +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 "" + +#: ../../page.rst:1309 54b22374ed6b4822965da643c06f80ff +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\")`." +msgstr "" + +#: ../../page.rst:1312 da37b797a9374bca99c9d5d0b55bf2be +msgid "**Key**" +msgstr "" + +#: ../../page.rst:1312 02ff32a75ec84f2d86e49d25404cdd9e +msgid "**Value**" +msgstr "" + +#: ../../page.rst:1314 298dfa6fed1b4d018ae47543322e34f8 +msgid "number" +msgstr "" + +#: ../../page.rst:1314 dbad54c7429e40cab971f8ac7009ca2e +msgid "block number *(int)*" +msgstr "" + +#: ../../page.rst:1315 00dc7159633244cebde1adec3dafad2e +msgid "bbox" +msgstr "" + +#: ../../page.rst:1315 6c320ed16d4a4363bfa8f2094c20dd6f +msgid "image bbox on page, :data:`rect_like`" +msgstr "" + +#: ../../page.rst:1316 445b56d25d8f470599cb6f93144c2670 +msgid "original image width *(int)*" +msgstr "" + +#: ../../page.rst:1317 c622ee730ec04832a42a095082927984 +msgid "height" +msgstr "" + +#: ../../page.rst:1317 cac7d43e70f6419589a692ec4a4bbe28 +msgid "original image height *(int)*" +msgstr "" + +#: ../../page.rst:1318 44e9d851ae3b44fd889e50c7906cfee7 +msgid "cs-name" +msgstr "" + +#: ../../page.rst:1318 c58e3a9b31ca4077a7dfeff8d4e41f30 +msgid "colorspace name *(str)*" +msgstr "" + +#: ../../page.rst:1319 e3500cbda86143859aeb3a83e6c2877a +msgid "colorspace" +msgstr "" + +#: ../../page.rst:1319 edad67e0bf6f4591b6b5d3e06e226bd8 +msgid "colorspace.n *(int)*" +msgstr "" + +#: ../../page.rst:1320 12b52796c8d24b3a97b3e4d4bc9699a9 +msgid "xres" +msgstr "" + +#: ../../page.rst:1320 a3d3fc441ac145c0b4efc69659507c63 +msgid "resolution in x-direction *(int)*" +msgstr "" + +#: ../../page.rst:1321 05fa370fcef5437787b06391cd541083 +msgid "yres" +msgstr "" + +#: ../../page.rst:1321 46368437d8ce4730bde715dc4d5ea3f0 +msgid "resolution in y-direction *(int)*" +msgstr "" + +#: ../../page.rst:1322 646819dfc7ea4cd482b6124b8eb5d09a +msgid "bpc" +msgstr "" + +#: ../../page.rst:1322 b3abdd4219b244618723dbcfaff2c4cf +msgid "bits per component *(int)*" +msgstr "" + +#: ../../page.rst:1323 c649d218ffb747ad89dec5d0f6f9c2dc +msgid "size" +msgstr "" + +#: ../../page.rst:1323 7fd062ab86c24b67b13980b812da12a2 +msgid "storage occupied by image *(int)*" +msgstr "" + +#: ../../page.rst:1324 13c402881edf4c52938605cd743e7c9b +msgid "digest" +msgstr "" + +#: ../../page.rst:1324 baf60a481580472bb228f01aa7b060a0 +msgid "MD5 hashcode *(bytes)*, if *hashes* is true" +msgstr "" + +#: ../../page.rst:1325 c700a2a942ff4a78815365c02758b889 +msgid "xref" +msgstr "" + +#: ../../page.rst:1325 2c3f3fa3ae344882ad9ca7f4e3d490e8 +msgid "image :data:`xref` or 0, if *xrefs* is true" +msgstr "" + +#: ../../page.rst:1326 2aebdb40c5024c31aa7d76f24311b830 +msgid "transform" +msgstr "" + +#: ../../page.rst:1326 8c06501acd35418aa7090e2f067e5864 +msgid "matrix transforming image rect to bbox, :data:`matrix_like`" +msgstr "" + +#: ../../page.rst:1329 1c2654af06d94206979f61cde8048372 +msgid "" +"Multiple occurrences of the same image are always reported. You can " +"detect duplicates by comparing their `digest` values." +msgstr "" + +#: ../../page.rst:1334 360889183bb04bea87f9e2e5e26806f8 +msgid "" +"PDF only: Return a list of Form XObjects referenced by the page. Wrapper " +"for :meth:`Document.get_page_xobjects`." +msgstr "" + +#: ../../page.rst:1342 9ba9129a06e54b56a1641733a91c7292 +msgid "*New in v1.18.13*" +msgstr "" + +#: ../../page.rst:1344 8faf90e21b794d7ba5494b46a4a15577 +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 "" + +#: ../../page.rst:1346 bfb20edc1b414a5ba82bab375f2be259 +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 "" + +#: ../../page.rst:1347 606781e43ddf44f486ea5ebca0db6252 +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 "" + +#: ../../page.rst:1348 41d5be04f81a42e49a9646eda1727615 +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 "" + +#: ../../page.rst:1350 cf84f9869ffe40b2a2b5cb845c5bf534 +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 "" + +#: ../../page.rst:1351 d2c84746c02d48e3af41307b73e3fd8d +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 "" + +#: ../../page.rst:1354 26430ce7fde24e989a5f5d07f17f974b +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:1362 de0cb6ac2fa0456c9856ebd4fb9a1112 +msgid "Changed in v1.18.11: return image transformation matrix" +msgstr "" + +#: ../../page.rst:1364 6b6e193f03024d1c84cf351999a9220c +msgid "" +"PDF only: Return boundary box and transformation matrix of an embedded " +"image." +msgstr "" + +#: ../../page.rst:1366 e14f34a255424cd9be73eea222643f65 +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 "" + +#: ../../page.rst:1367 ffc6d4794d2c4a318ce1155ded22eb7f +msgid "" +"*(new in v1.18.11)* also return the matrix used to transform the image " +"rectangle to the bbox on the page. Default is just the bbox. If true, " +"then a tuple `(bbox, matrix)` is returned." +msgstr "" + +#: ../../page.rst:1369 8d7aedab71e24ccf8042992346c461fd +msgid ":ref:`Rect` or (:ref:`Rect`, :ref:`Matrix`)" +msgstr "" + +#: ../../page.rst:1370 60568d26346a480580d5f16f0d328223 +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 "" + +#: ../../page.rst:1370 256ef35966c04331af738f0db0041d00 +msgid "" +"the boundary box of the image -- optionally also its transformation " +"matrix." +msgstr "" + +#: ../../page.rst:1372 e604466bdd754266a524e7ab78909aee +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 "" + +#: ../../page.rst:1373 86cb04e3498e41a4ae660bc7cf9bce71 +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 "" + +#: ../../page.rst:1374 8cf53e24580c450ba7b00d6b1b0d25af +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 "" + +#: ../../page.rst:1375 5fb82f35e8a743709e19a6febf766510 +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 "" + +#: ../../page.rst:1376 c1b4c973b59846d699a5eadebcb9bb70 +msgid "" +"*(Changed in v1.18.11)* -- Optionally also return the transformation " +"matrix together with the bbox as the tuple `(bbox, transform)`." +msgstr "" + +#: ../../page.rst:1380 9e51ae4bf861409d977ec2440240c8a3 +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 "" + +#: ../../page.rst:1381 6edf330503b34fe4a3235415f07ad263 +msgid "" +"The image's \"transformation matrix\" is defined as the matrix, for which" +" the expression `bbox / transform == fitz.Rect(0, 0, 1, 1)` is true, " +"lookup details here: :ref:`ImageTransformation`." +msgstr "" + +#: ../../page.rst:1388 0232768a22414c33af3152e023e63259 +msgid "" +"Create an SVG image from the page. Only full page images are currently " +"supported." +msgstr "" + +#: ../../page.rst:1390 224816c1f6fb4e93ad055d54d3e5fc94 +msgid "a matrix, default is :ref:`Identity`." +msgstr "" + +#: ../../page.rst:1391 12afbe9bf04b44a9b35427e34cf391e8 +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 "" + +#: ../../page.rst:1393 4a78e085322c40cca7bb12c41d3719a8 +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:1393 e0c4f6335d474ad78ebead18699adb4b +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 "" + +#: ../../page.rst:1395 acbd3a249d5b4d338456156314ccf4ea +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 "" + +#: ../../page.rst:1407 511185bf213047baa2c629fafc1c4a2d +msgid "Changed in v1.19.2: added support of parameter dpi." +msgstr "" + +#: ../../page.rst:1409 d3e9204a61044fc084bd603c0a14955d +msgid "" +"Create a pixmap from the page. This is probably the most often used " +"method to create a :ref:`Pixmap`." +msgstr "" + +#: ../../page.rst:1411 6aea446a806c429c9cfae3d40efc4b03 +msgid "All parameters are *keyword-only.*" +msgstr "" + +#: ../../page.rst:1413 2b096cadd8274ab297d104eccc73e89f +msgid "default is :ref:`Identity`." +msgstr "" + +#: ../../page.rst:1414 c1c4896587304c10ae3f884c2a051f5f +msgid "" +"(new in v1.19.2) desired resolution in x and y direction. If not `None`, " +"the `\"matrix\"` parameter is ignored." +msgstr "" + +#: ../../page.rst:1415 68b35416524540b09c7449158eb7bfcd +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 "" + +#: ../../page.rst:1417 624f5cb486db4109a63fe43385f00225 +msgid "" +"restrict rendering to the intersection of this area with the page's " +"rectangle." +msgstr "" + +#: ../../page.rst:1418 0aaabc0f0bd540579168d7146a76d925 +#, 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. " +"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 "" + +#: ../../page.rst:1418 de3ccd8bb1284735bc11df033bd6edc5 +#, 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 "" + +#: ../../page.rst:1430 d7c6351994ec499e9a4ef5f1ed149f17 +msgid "Changed in v1.14.17" +msgstr "" + +#: ../../page.rst:1421 da7950125f4f4213922c9568aec85732 +msgid "The default alpha value is now *False*." +msgstr "" + +#: ../../page.rst:1423 8ff7ce8c8cf5463ab9273e682914da0a +msgid "Generated with *alpha=True*" +msgstr "" + +#: ../../page.rst:1428 ce1c4bd35ffb4ec9aedb3ba98a66f4ba +msgid "Generated with *alpha=False*" +msgstr "" + +#: ../../page.rst:1432 70de2329efb34139a55d0e2bb2fd0c2a +msgid "" +"*(new in version 1.16.0)* whether to also render annotations or to " +"suppress them. You can create pixmaps for annotations separately." +msgstr "" + +#: ../../page.rst:1434 82f11ac099a247c9b96dcec88fe6cbd9 +msgid ":ref:`Pixmap`" +msgstr "" + +#: ../../page.rst:1435 bfa0a72c976843afbb79e3ec6de72af4 +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 "" + +#: ../../page.rst:1438 cdecf52907924fd3ae64f968c937c58f +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 "" + +#: ../../page.rst:1458 ede92a92dfa24a98a7995aaf5eea3d9e +msgid "New in v1.16.10" +msgstr "" + +#: ../../page.rst:1460 97d17403e87a4710bb04398c3f314f43 +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 "" + +#: ../../page.rst:1467 ../../page.rst:1477 61c7841a8dde4abda2c3cefd81d8fbb2 +#: b267743d7e654e90b207cd4d6079a4b4 +msgid "New in v1.17.1" +msgstr "" + +#: ../../page.rst:1469 3a866105f16747c19c633277b485f35c +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 "" + +#: ../../page.rst:1472 4002a85b76014f0a958372737c7c3630 +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 "" + +#: ../../page.rst:1479 af45911490aa4ceeb1b12fe56dac6d0d +msgid "" +"PDF only: return the annotation identified by *ident*. This may be its " +"unique name (PDF `/NM` key), or its :data:`xref`." +msgstr "" + +#: ../../page.rst:1481 84ca52130b8d436b904e6691d221363a +msgid "the annotation name or xref." +msgstr "" + +#: ../../page.rst:1484 c3c4c163cb2f4a058c30cbefe7b8b664 +msgid "the annotation or *None*." +msgstr "" + +#: ../../page.rst:1486 a79a26b21cf6463c994eb6c2aabc3256 +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 "" + +#: ../../page.rst:1490 afd263e23628457386dd78d9f02d42da +msgid "New in v1.19.6" +msgstr "" + +#: ../../page.rst:1492 e080909ad9984f238f17a95e9e01fb42 +msgid "PDF only: return the field identified by *xref*." +msgstr "" + +#: ../../page.rst:1494 fa38d5da08da4cc09aa1f47bcaa7c6d7 +msgid "the field's xref." +msgstr "" + +#: ../../page.rst:1497 d48f7e5f88544e019e3ab94ba7b7b24e +msgid "the field or *None*." +msgstr "" + +#: ../../page.rst:1499 6be168dec232402e84afbaabc611a88f +msgid "" +"This is similar to the analogous method :meth:`Page.load_annot` -- except" +" that here only the xref is supported as identifier." +msgstr "" + +#: ../../page.rst:1503 1eb96d6f576544c1917401dd110abe4e +msgid "Return the first link on a page. Synonym of property :attr:`first_link`." +msgstr "" + +#: ../../page.rst:1505 ../../page.rst:1751 291651f2a62f40a7a7e034e6db15e021 +#: 2bfdd95bd6a7479892f40a289d4e2fae +msgid ":ref:`Link`" +msgstr "" + +#: ../../page.rst:1506 a8837ca84e814a0493b8a4a3e51534ce +msgid "first link on the page (or *None*)." +msgstr "" + +#: ../../page.rst:1513 481b6e2f0e934000b137853c0b57117f +msgid "PDF only: Set the rotation of the page." +msgstr "" + +#: ../../page.rst:1515 169dad5ad8aa4d978532d4e9303aed26 +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 "" + +#: ../../page.rst:1525 2f4ae56ccf124059b70546dc90add065 +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 "" + +#: ../../page.rst:1526 74743a1951ec401b851ec4e0efff2170 +msgid "Changed in v1.18.3: New parameter `oc`." +msgstr "" + +#: ../../page.rst:1528 f9fd22530ad24035859807348a44f331 +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 "" + +#: ../../page.rst:1530 ee7999ccc91f46ee85c26df388b27739 +msgid "" +"create \"n-up\" versions of existing PDF files, combining several input " +"pages into **one output page** (see example `combine.py " +"`_)," +msgstr "" + +#: ../../page.rst:1531 75c600bdf8e94426b930325e33004829 +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 "" + +#: ../../page.rst:1532 a08619375a73440f9e75569c020b6105 +msgid "" +"include PDF-based vector images like company logos, watermarks, etc., see" +" `svg-logo.py `_, which puts an SVG-based " +"logo on each page (requires additional packages to deal with SVG-to-PDF " +"conversions)." +msgstr "" + +#: ../../page.rst:1534 ca853ddd23f6417cbbb9ec0acbb82c21 +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:1535 faa2807289324a618dc4aac348e1b311 +msgid "" +"source PDF document containing the page. Must be a different document " +"object, but may be the same file." +msgstr "" + +#: ../../page.rst:1538 5377a2024c064e6f92f61e41e1df2ced +msgid "page number (0-based, in `-∞ < pno < docsrc.page_count`) to be shown." +msgstr "" + +#: ../../page.rst:1540 3b3aee8abfd046b7a5203c4a8ef95436 +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 "" + +#: ../../page.rst:1542 b5a3d0203dc64c8e9f844a178076166e +msgid "put image in foreground (default) or background." +msgstr "" + +#: ../../page.rst:1544 4348a4f6d35a4b619e1e02b31d7cf029 +msgid "" +"*(new in v1.18.3)* (:data:`xref`) make visibility dependent on this " +":data:`OCG` / :data:`OCMD` (which must be defined in the target PDF) " +"[#f9]_." +msgstr "" + +#: ../../page.rst:1545 4042af61898f405bbcc725da1a61af27 +msgid "" +"*(new in v1.14.10)* show the source rectangle rotated by some angle. " +"*Changed in v1.14.11:* Any angle is now supported." +msgstr "" + +#: ../../page.rst:1547 0bb1238af00a4209aa8253b6f38c4931 +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:1549 604919c858464d1bb3d0570fea3afa31 +msgid "" +"In contrast to method :meth:`Document.insert_pdf`, this method does not " +"copy annotations, widgets or links, so these 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 "" + +#: ../../page.rst:1551 8af4b9c048924ebca1c29feec2a2ea20 +msgid "Example: Show the same source page, rotated by 90 and by -90 degrees:" +msgstr "" + +#: ../../page.rst:1573 fa6178affed54dc094eb919ebb24e82f +msgid "PDF only: Create a new :ref:`Shape` object for the page." +msgstr "" + +#: ../../page.rst:1575 5c9ddf905fb84c999fa7ba80ec09aa1b +msgid ":ref:`Shape`" +msgstr "" + +#: ../../page.rst:1576 5c37fe75eb8d4c75a64105886339b273 +msgid "a new :ref:`Shape` to use for compound drawings. See description there." +msgstr "" + +#: ../../page.rst:1587 81bd1beef62d411da71a5d94f32d0693 +msgid "" +"Changed in v1.18.2: added `clip` parameter. Remove `hit_max` parameter. " +"Add default \"dehyphenate\"." +msgstr "" + +#: ../../page.rst:1588 535ef638764f4ab6bc469e5f67dc94df +msgid "Changed in v1.19.0: added `textpage` parameter." +msgstr "" + +#: ../../page.rst:1590 5b64a2f3f56e482dbad3b542eb901148 +msgid "Search for *needle* on a page. Wrapper for :meth:`TextPage.search`." +msgstr "" + +#: ../../page.rst:1592 f392134343b848b2b72ef9e83e1ef334 +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 "" + +#: ../../page.rst:1593 86d970283ffa41648b6b840df30b4e6a +msgid "*(New in v1.18.2)* only search within this area." +msgstr "" + +#: ../../page.rst:1594 1445013700f94a66bf7298c778a284da +msgid "Return object type :ref:`Quad` instead of :ref:`Rect`." +msgstr "" + +#: ../../page.rst:1595 0e000cae7ce24adabd291913058f681f +msgid "" +"Control the data extracted by the underlying :ref:`TextPage`. By default," +" ligatures and white spaces are kept, and hyphenation [#f8]_ is detected." +msgstr "" + +#: ../../page.rst:1596 4628b1453b474f8b8534a9b24b96a487 +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 "" + +#: ../../page.rst:1600 2ab6189ab1ee42e7989501ba3e5bfdf5 +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 "" + +#: ../../page.rst:1602 1323e77f6a094e7eb4aefa0f6d72d0fa +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 "" + +#: ../../page.rst:1604 04d6de6d7bfa43988b88fb212c034874 +msgid "**Changes in v1.18.2:**" +msgstr "" + +#: ../../page.rst:1606 05e2e307bbe3441f9f74d9a65c096964 +msgid "" +"There no longer is a limit on the list length (removal of the `hit_max` " +"parameter)." +msgstr "" + +#: ../../page.rst:1607 f001533f21b64c2abc236e31649e1391 +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 "" + +#: ../../page.rst:1609 1858e35e300641d5b8c795d5b9cd802a +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:1613 4118b2e634b4484ea6d8a1437ec112ea +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 "" + +#: ../../page.rst:1614 07bc4d1d17c94f3f81ffe4eef2ca8310 +msgid "" +"You can always use :meth:`Page.get_textbox` to check what text actually " +"is being surrounded by each rectangle." +msgstr "" + +#: ../../page.rst:1616 9b04312b1d214eeb9a2602a1f7b66807 +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 "" + +#: ../../page.rst:1622 fe6af83c78864b1eb379d618db60cffd +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 "" + +#: ../../page.rst:1627 d33a4d70167742e6b7ff551f3fb68f56 +msgid "New in v1.16.13" +msgstr "" + +#: ../../page.rst:1628 6ff5e80f17ba4c939c9b95d471faaf75 +msgid "Changed in v1.19.4: remove all other rectangle definitions." +msgstr "" + +#: ../../page.rst:1630 f12cc2d45388496e9607ccf656f65ee0 +msgid "" +"PDF only: Change the physical page dimension by setting :data:`mediabox` " +"in the page's object definition." +msgstr "" + +#: ../../page.rst:1632 445c191a2f984d12b59bfb02eb6d9ae4 +msgid "the new :data:`mediabox` value." +msgstr "" + +#: ../../page.rst:1634 12b77045c84e43b6961ad7cdc98e8813 +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 "" + +#: ../../page.rst:1636 c347065560704f06907ac120c438e18d +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:1641 9dcabe97ede6414198bb3001f03eaff9 +msgid "PDF only: change the visible part of the page." +msgstr "" + +#: ../../page.rst:1643 afb486222f144196bfaa3a851422fa3c +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 "" + +#: ../../page.rst:1645 cb678f2a33934923b0bbc1504dc33ba0 +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 "" + +#: ../../page.rst:1676 9d6ca41b25bf465a91e5db9805ab9bd3 +msgid "New in v1.19.4" +msgstr "" + +#: ../../page.rst:1678 38b601d914e04bf7ab60bc1823a83abb +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 "" + +#: ../../page.rst:1683 c586c6f7862e4c5fad726e7c3ed89e82 +msgid "Contains the rotation of the page in degrees (always 0 for non-PDF types)." +msgstr "" + +#: ../../page.rst:1689 cd3f10af32a64780a8806d55e4a68fcb +msgid "" +"Contains the top-left point of the page's `/CropBox` for a PDF, otherwise" +" *Point(0, 0)*." +msgstr "" + +#: ../../page.rst:1691 ../../page.rst:1715 13e85e28d9dc4a2cb6ad1ee57c96d8a5 +#: af52cefbf8b541c8899be56d93e40476 +msgid ":ref:`Point`" +msgstr "" + +#: ../../page.rst:1695 166570bc240047688a1a3f5a2df6eacf +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 "" + +#: ../../page.rst:1697 3370ae6813bf44bf9d9e47a5b2e5844d +msgid "" +"In PDF, the relationship between `/MediaBox`, `/CropBox` and page " +"rectangle may sometimes be confusing, please do lookup the glossary for " +":data:`MediaBox`." +msgstr "" + +#: ../../page.rst:1707 ce0d766e127a4b7a8a775151968bb79f +msgid "" +"The page's `/ArtBox`, `/BleedBox`, `/TrimBox`, respectively. If not " +"provided, defaulting to :attr:`Page.cropbox`." +msgstr "" + +#: ../../page.rst:1713 64bac5d6a60e4a0ba02394f377287fa3 +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 "" + +#: ../../page.rst:1719 38858a804a9f4d33b7634f4600949145 +msgid "The page's :data:`mediabox` for a PDF, otherwise :attr:`Page.rect`." +msgstr "" + +#: ../../page.rst:1723 295bda42b4214f1daf0338fee33464b6 +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 "" + +#: ../../page.rst:1727 b56bc941d2864969848d4e73ce214396 +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 "" + +#: ../../page.rst:1729 ../../page.rst:1745 7c7a4b86095b43da80dd081830e9d0ed +#: b699cf7254ab4b5ca85baf390beebf78 +msgid ":ref:`Matrix`" +msgstr "" + +#: ../../page.rst:1735 c478b284987c4b06812cccd7ae9b7d85 +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 "" + +#: ../../page.rst:1749 982e8005c24f400482041674d0e672ea +msgid "Contains the first :ref:`Link` of a page (or *None*)." +msgstr "" + +#: ../../page.rst:1755 a0ebeb1b06e446b78fffd1c19b4ed785 +msgid "Contains the first :ref:`Annot` of a page (or *None*)." +msgstr "" + +#: ../../page.rst:1761 7fa1fb6af6df431597cac17d8c65610d +msgid "Contains the first :ref:`Widget` of a page (or *None*)." +msgstr "" + +#: ../../page.rst:1767 5d118200978f454ea68a50c280211c67 +msgid "The page number." +msgstr "" + +#: ../../page.rst:1773 c17da81053674d8dbb64ed4884bba13a +msgid "The owning document object." +msgstr "" + +#: ../../page.rst:1775 e73a865a959a4145bcb7b13102d9a926 +msgid ":ref:`Document`" +msgstr "" + +#: ../../page.rst:1780 d87c15e1bec74b60bec82ae3de199325 +msgid "" +"Contains the rectangle of the page. Same as result of " +":meth:`Page.bound()`." +msgstr "" + +#: ../../page.rst:1786 94523a03e7fd4022b33024b21436562e +msgid "The page's PDF :data:`xref`. Zero if not a PDF." +msgstr "" + +#: ../../page.rst:1793 9d4c6143afc4431c94b1aced94c81655 +msgid "Description of *get_links()* Entries" +msgstr "" + +#: ../../page.rst:1794 346de344e7824b42b3455e3a108e5a54 +msgid "" +"Each entry of the :meth:`Page.get_links` list is a dictionary with the " +"following keys:" +msgstr "" + +#: ../../page.rst:1796 b2e0c3f71a8a4232a78ac08d968aa1f2 +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 "" + +#: ../../page.rst:1798 cafafc97c5894df4b37528f2363221be +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 "" + +#: ../../page.rst:1800 fdb1561b29a540bbaaba704a2e4adf0b +msgid "" +"*page*: a 0-based integer indicating the destination page. Required for " +"*LINK_GOTO* and *LINK_GOTOR*, else ignored." +msgstr "" + +#: ../../page.rst:1802 c08118854f9a496aab2e0f6137b6bda6 +msgid "" +"*to*: either a *fitz.Point*, specifying the destination location on the" +" provided page, default is *fitz.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 "" + +#: ../../page.rst:1804 d7fe8739e2174a769603331663f2cc7b +msgid "" +"*file*: a string specifying the destination file. Required for " +"*LINK_GOTOR* and *LINK_LAUNCH*, else ignored." +msgstr "" + +#: ../../page.rst:1806 7b4f9058c91a4d7794d0ad4c6802e360 +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 "" + +#: ../../page.rst:1808 3c6d057e91d040dfa2035ca81b0a5267 +msgid "" +"*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 the note below." +msgstr "" + +#: ../../page.rst:1811 b955777e6b7a47fbae35665923d9ca1a +msgid "Notes on Supporting Links" +msgstr "" + +#: ../../page.rst:1812 616c079589d745b298a8db8672f21ddd +msgid "" +"MuPDF's support for links has changed in **v1.10a**. These changes affect" +" link types :data:`LINK_GOTO` and :data:`LINK_GOTOR`." +msgstr "" + +#: ../../page.rst:1815 83778143358d46768083633e70d7238a +msgid "" +"Reading (pertains to method *get_links()* and the *first_link* property " +"chain)" +msgstr "" + +#: ../../page.rst:1817 19d7fcf6229a4540a6414e0d9ba2311b +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 "" + +#: ../../page.rst:1819 7d2bfa83e2ba48ca840eb888018cdb3f +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.rst:1821 2a40d95c1d9644b2aad420ca96bf19ac +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 "" + +#: ../../page.rst:1824 08f8791552434efaa8cf0e842bd052ef +msgid "Writing" +msgstr "" + +#: ../../page.rst:1826 cde9d6294f1743588a44f50c8ceb7dc0 +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 "" + +#: ../../page.rst:1828 6deb3e2ad4164123a7e814e0765cf947 +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 "" + +#: ../../page.rst:1830 2bc59cc331dc4dafa355687aa49d4c79 +msgid "" +"Indirect *LINK_GOTOR* destinations can in general of course not be " +"checked for validity and are therefore **always accepted**." +msgstr "" + +#: ../../page.rst:1832 f9434dba01e646f6b042f794457c86e0 +msgid "" +"**Example: How to insert a link pointing to another page in the same " +"document**" +msgstr "" + +#: ../../page.rst:1834 578c4ffcebec4c0dbfcca5de00840e12 +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 "" + +#: ../../page.rst:1836 d6bfe828769243f9a43d39b7467c20a9 +msgid "" +"Determine the target page number (\"pno\", 0-based) and a :ref:`Point` on" +" it, where the link should be directed to." +msgstr "" + +#: ../../page.rst:1838 dcad4e628e1e466b836773b72f07d7f1 +msgid "" +"Create a dictionary `d = {\"kind\": fitz.LINK_GOTO, \"page\": pno, " +"\"from\": bbox, \"to\": point}`." +msgstr "" + +#: ../../page.rst:1840 3fb35e1a40b64b578e703453a52487de +msgid "Execute `page.insert_link(d)`." +msgstr "" + +#: ../../page.rst:1844 9b21dca80e0f4efd8cd4d22c758a9d20 +msgid "Homologous Methods of :ref:`Document` and :ref:`Page`" +msgstr "" + +#: ../../page.rst:1845 710af9b73bf64508a10e55c985ecf802 +msgid "" +"This is an overview of homologous methods on the :ref:`Document` and on " +"the :ref:`Page` level." +msgstr "" + +#: ../../page.rst:1848 dc056d052fee413883d8d6e8925c83af +msgid "**Document Level**" +msgstr "" + +#: ../../page.rst:1848 19d0d60e676243498bc0edccc8738183 +msgid "**Page Level**" +msgstr "" + +#: ../../page.rst:1850 32cb08b61f6a4573a443f17e41c71fc3 +msgid "*Document.get_page_fonts(pno)*" +msgstr "" + +#: ../../page.rst:1851 d75e1d72b25149b799ed1e50e39f230a +msgid "*Document.get_page_images(pno)*" +msgstr "" + +#: ../../page.rst:1852 bc6b8513dc774046bf71e4bd548499fe +msgid "*Document.get_page_pixmap(pno, ...)*" +msgstr "" + +#: ../../page.rst:1853 086f577792c54931a5b3e886dd6e350e +msgid "*Document.get_page_text(pno, ...)*" +msgstr "" + +#: ../../page.rst:1854 78c4b30d64014ec6a2232d6ea2aa2eb9 +msgid "*Document.search_page_for(pno, ...)*" +msgstr "" + +#: ../../page.rst:1857 0d645c8d286a43b087a17e189d523968 +msgid "The page number \"pno\" is a 0-based integer `-∞ < pno < page_count`." +msgstr "" + +#: ../../page.rst:1861 e7e46660a6e9497db627c1ac2def0ef3 +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 "" + +#: ../../page.rst:1863 1478ba549e6149e9966da51f1723d34a +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 "" + +#: ../../page.rst:1866 b34bd570d24d408fafbee219244ac804 +msgid "Footnotes" +msgstr "" + +#: ../../page.rst:1867 a0d00045bcfc42d19c3e78faae49ef5d +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 "" + +#: ../../page.rst:1869 7ed4b65da91246419792f40912540546 +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 "" + +#: ../../page.rst:1871 8e17b881b9ea4acc91fd6e73bd084bf3 +msgid "" +"Not all PDF readers display these fonts at all. Some others do, but use a" +" wrong character spacing, etc." +msgstr "" + +#: ../../page.rst:1873 ae50a51fc31245cabf7c2a1b7f495e0e +msgid "" +"You are generally free to choose any of the :ref:`mupdficons` you " +"consider adequate." +msgstr "" + +#: ../../page.rst:1875 23fcda357d574e4a8c7ad99d431bba91 +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 "" + +#: ../../page.rst:1877 e65c5133556d4c0f9f865c94a5474bcd +msgid "" +"If you need to also see annotations or fields in the target page, you can" +" try and convert the source PDF to another PDF using " +":meth:`Document.convert_to_pdf`. 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 "" + +#: ../../page.rst:1879 f2d2a20dff094f36a6bb46ac11a96ca4 +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 "" + +#: ../../page.rst:1881 fda2b055a9d0494ba2de64138a701acd +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 "" + +#: ../../page.rst:1883 88681a5388f5473db129e6363bfbe689 +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 "" + +#: ../../footer.rst:-1 8ed5450a25534b35a92c5f6abff127a7 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/pixmap.mo b/docs/locales/ja/LC_MESSAGES/pixmap.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/pixmap.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/pixmap.po b/docs/locales/ja/LC_MESSAGES/pixmap.po new file mode 100644 index 000000000..26362276f --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/pixmap.po @@ -0,0 +1,1767 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../pixmap.rst:7 426412b5a11a4d78914ccc56b2f0f558 +msgid "Pixmap" +msgstr "" + +#: ../../pixmap.rst:9 22de83865abe4e559aab6ef8d60770cd +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.rst:11 9b07141933284b21afd9f4b85c23d341 +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 "" + +#: ../../pixmap.rst:13 cac802e02c7d44a69b6b5a1fef77542d +msgid "from a document page (method :meth:`Page.get_pixmap`)" +msgstr "" + +#: ../../pixmap.rst:14 8f23fa86855d4752b41dd0e8f2cf584b +msgid "empty, based on :ref:`Colorspace` and :ref:`IRect` information" +msgstr "" + +#: ../../pixmap.rst:15 b71fcfeb93fe4001a68fffea74e05ba5 +msgid "from a file" +msgstr "" + +#: ../../pixmap.rst:16 9ae50b2272fe442abd1b7d0d4a99bcf1 +msgid "from an in-memory image" +msgstr "" + +#: ../../pixmap.rst:17 b26f6ffa142543e29ebb0bf9e38e9dfc +msgid "from a memory area of plain pixels" +msgstr "" + +#: ../../pixmap.rst:18 af6f1b0e1bc84bec92e27b77077fd6bd +msgid "from an image inside a PDF document" +msgstr "" + +#: ../../pixmap.rst:19 516e9bb51c9c44d580f9725203bd353f +msgid "as a copy of another pixmap" +msgstr "" + +#: ../../pixmap.rst:21 14b9aa01b5124a93ac4b52a92fd7b900 +msgid "" +"A number of image formats is supported as input for points 3. and 4. " +"above. See section :ref:`ImageFiles`." +msgstr "" + +#: ../../pixmap.rst:23 76a3687169cf434daaa448178f92d834 +msgid "" +"Have a look at the :ref:`FAQ` section to see some pixmap usage \"at " +"work\"." +msgstr "" + +#: ../../pixmap.rst:26 20bca795212a407ea2fb5f786a9d6e1a +msgid "**Method / Attribute**" +msgstr "" + +#: ../../pixmap.rst:26 dc7ed2b971f242ac96d4f6f3848dc60f +msgid "**Short Description**" +msgstr "" + +#: ../../pixmap.rst:28 40515a2a7a2740aab04efa66f367c054 +msgid ":meth:`Pixmap.clear_with`" +msgstr "" + +#: ../../pixmap.rst:28 ccae0fddfb6c448e8f1d0bad3f92ccb4 +msgid "clear parts of the pixmap" +msgstr "" + +#: ../../pixmap.rst:29 1155cd2e8a8b450b95eda5a9a2b0fd00 +msgid ":meth:`Pixmap.color_count`" +msgstr "" + +#: ../../pixmap.rst:29 32ff8c9747a146ca92b48ddeb288bdf8 +msgid "determine used colors" +msgstr "" + +#: ../../pixmap.rst:30 a5bc3d72833149b99099a1fbebc8fa70 +msgid ":meth:`Pixmap.color_topusage`" +msgstr "" + +#: ../../pixmap.rst:30 76fee0af1a78414b87ce47e5509e184f +msgid "determine share of most used color" +msgstr "" + +#: ../../pixmap.rst:31 1881d3ded9194247a26c4ec3813b5086 +msgid ":meth:`Pixmap.copy`" +msgstr "" + +#: ../../pixmap.rst:31 8aca84e4bdf3498b9fff742323186f33 +msgid "copy parts of another pixmap" +msgstr "" + +#: ../../pixmap.rst:32 9089f8128a1d42b6a3269618c135debb +msgid ":meth:`Pixmap.gamma_with`" +msgstr "" + +#: ../../pixmap.rst:32 5c791f3cfce04aff822c5e8880d1f92a +msgid "apply a gamma factor to the pixmap" +msgstr "" + +#: ../../pixmap.rst:33 55d63bc8022e4fb0babe5338b225e833 +msgid ":meth:`Pixmap.invert_irect`" +msgstr "" + +#: ../../pixmap.rst:33 6956f32bebb54a80af9adeb68af726e9 +msgid "invert the pixels of a given area" +msgstr "" + +#: ../../pixmap.rst:34 18cfb5f991354e9d8d8a2a8f64a778fb +msgid ":meth:`Pixmap.pdfocr_save`" +msgstr "" + +#: ../../pixmap.rst:34 ../../pixmap.rst:35 92cfefde1b5743338aaeb6d8ff577ec2 +#: 9695809e8c0147b498f0ad5d465e7bb5 +msgid "save the pixmap as an OCRed 1-page PDF" +msgstr "" + +#: ../../pixmap.rst:35 7de4e80f3fad4e69a5b8a194d2e74359 +msgid ":meth:`Pixmap.pdfocr_tobytes`" +msgstr "" + +#: ../../pixmap.rst:36 4f345976a9c74cadbeb70fb1d5c387a0 +msgid ":meth:`Pixmap.pil_save`" +msgstr "" + +#: ../../pixmap.rst:36 47261bb7cf844d41aa9dfae0321769a0 +msgid "save as image using pillow" +msgstr "" + +#: ../../pixmap.rst:37 26fb643adf4745969e63001cacc4fd87 +msgid ":meth:`Pixmap.pil_tobytes`" +msgstr "" + +#: ../../pixmap.rst:37 8a743639c9f14326b2c296c3e0260211 +msgid "write to `bytes` object using pillow" +msgstr "" + +#: ../../pixmap.rst:38 315cad64fe4e45cc9aac09cf071e0bb7 +msgid ":meth:`Pixmap.pixel`" +msgstr "" + +#: ../../pixmap.rst:38 4a3badc364d747c9b3987b0e3805b008 +msgid "return the value of a pixel" +msgstr "" + +#: ../../pixmap.rst:39 3846548533cf4f178f25855d10a9b92a +msgid ":meth:`Pixmap.save`" +msgstr "" + +#: ../../pixmap.rst:39 9f99e3604c6c44bcb0f2d551b443feae +msgid "save the pixmap in a variety of formats" +msgstr "" + +#: ../../pixmap.rst:40 bf66d1c934534b078cf2bc857bcd3fbe +msgid ":meth:`Pixmap.set_alpha`" +msgstr "" + +#: ../../pixmap.rst:40 c70c6ad4e0104e62ae2e7a83e00eec45 +msgid "set alpha values" +msgstr "" + +#: ../../pixmap.rst:41 3cafdc9da0c84e54b72ec4fe541d8cb4 +msgid ":meth:`Pixmap.set_dpi`" +msgstr "" + +#: ../../pixmap.rst:41 36c976691e974b4f88b8d61332dcb24d +msgid "set the image resolution" +msgstr "" + +#: ../../pixmap.rst:42 7fa25b5c4c5144bd9ce165f3fa7b3c18 +msgid ":meth:`Pixmap.set_origin`" +msgstr "" + +#: ../../pixmap.rst:42 3673474dd20f48658d2169ea79e6f40f +msgid "set pixmap x,y values" +msgstr "" + +#: ../../pixmap.rst:43 9268828b214e4f8eb08a3ee4e00da8d2 +msgid ":meth:`Pixmap.set_pixel`" +msgstr "" + +#: ../../pixmap.rst:43 e7b10a47d5d8442f9b7d0751fff80f87 +msgid "set color and alpha of a pixel" +msgstr "" + +#: ../../pixmap.rst:44 ea58f485ee2f4ee6b2fd85dc1844f3f4 +msgid ":meth:`Pixmap.set_rect`" +msgstr "" + +#: ../../pixmap.rst:44 8e9ea0573a8340919fe5682805198c6b +msgid "set color and alpha of all pixels in a rectangle" +msgstr "" + +#: ../../pixmap.rst:45 4f02093755094b778384d20e96d35d7f +msgid ":meth:`Pixmap.shrink`" +msgstr "" + +#: ../../pixmap.rst:45 ad2151a6b5cd4d07a20cc871df694ea2 +msgid "reduce size keeping proportions" +msgstr "" + +#: ../../pixmap.rst:46 1f2ac8b612c84950a73f5eba89fa8dff +msgid ":meth:`Pixmap.tint_with`" +msgstr "" + +#: ../../pixmap.rst:46 e61144c3aebf4354aec0ab8a0664eee5 +msgid "tint the pixmap" +msgstr "" + +#: ../../pixmap.rst:47 8dd7c4cbcdc641baa457698f133be829 +msgid ":meth:`Pixmap.tobytes`" +msgstr "" + +#: ../../pixmap.rst:47 a99ec6eb30644c3f8760c445b8fdd1b9 +msgid "return a memory area in a variety of formats" +msgstr "" + +#: ../../pixmap.rst:48 4cc1c9607ae849a8928b393a408befb6 +msgid ":meth:`Pixmap.warp`" +msgstr "" + +#: ../../pixmap.rst:48 b5b8dab994164181b8fe0a596087c954 +msgid "return a pixmap made from a quad inside" +msgstr "" + +#: ../../pixmap.rst:49 46cdaf54b1064a488baeb5da08fb6ad2 +msgid ":attr:`Pixmap.alpha`" +msgstr "" + +#: ../../pixmap.rst:49 90cdcd3970cc41c78a3ec9df3eaee429 +msgid "transparency indicator" +msgstr "" + +#: ../../pixmap.rst:50 91ca0541be7d4f55905d46f42754bbe3 +msgid ":attr:`Pixmap.colorspace`" +msgstr "" + +#: ../../pixmap.rst:50 856117e85c7c4bdf8f6ff1a7bc1259b7 +msgid "pixmap's :ref:`Colorspace`" +msgstr "" + +#: ../../pixmap.rst:51 a75052ef481540f7a6a54b216247c131 +msgid ":attr:`Pixmap.digest`" +msgstr "" + +#: ../../pixmap.rst:51 23f7d7b5957842398ee167a2b04a66b2 +msgid "MD5 hashcode of the pixmap" +msgstr "" + +#: ../../pixmap.rst:52 b1ea0d5ac84146799dbc91359793956f +msgid ":attr:`Pixmap.height`" +msgstr "" + +#: ../../pixmap.rst:52 49ede39d16e74a61a97ad504c1c11b5c +msgid "pixmap height" +msgstr "" + +#: ../../pixmap.rst:53 7a638f5a8df44a08a113e3e86f5763c3 +msgid ":attr:`Pixmap.interpolate`" +msgstr "" + +#: ../../pixmap.rst:53 f7260776dda64f17b09cdc10e8f9f02a +msgid "interpolation method indicator" +msgstr "" + +#: ../../pixmap.rst:54 82060abb35f240a3a2320a726da6f685 +msgid ":attr:`Pixmap.is_monochrome`" +msgstr "" + +#: ../../pixmap.rst:54 a089cc60f64443a0b7a6c4792a9b3efd +msgid "check if only black and white occur" +msgstr "" + +#: ../../pixmap.rst:55 9c5068e190094c30aa57b14a514e53f4 +msgid ":attr:`Pixmap.is_unicolor`" +msgstr "" + +#: ../../pixmap.rst:55 7fa921ede8434bf7a337805b148d1b15 +msgid "check if only one color occurs" +msgstr "" + +#: ../../pixmap.rst:56 3f72387936e74a90b08ab61620b65093 +msgid ":attr:`Pixmap.irect`" +msgstr "" + +#: ../../pixmap.rst:56 73e5990ef37c4313a934ce3aaa7d5b7d +msgid ":ref:`IRect` of the pixmap" +msgstr "" + +#: ../../pixmap.rst:57 036d0d240f6348da81fa25228ccff2c6 +msgid ":attr:`Pixmap.n`" +msgstr "" + +#: ../../pixmap.rst:57 f8d7317c1ff54fc0af788f0c52ab78fd +msgid "bytes per pixel" +msgstr "" + +#: ../../pixmap.rst:58 2230cca4aaf644beb493a74233688642 +msgid ":attr:`Pixmap.samples_mv`" +msgstr "" + +#: ../../pixmap.rst:58 6e7234eb5cc040b1a44847abfcd189b1 +msgid "`memoryview` of pixel area" +msgstr "" + +#: ../../pixmap.rst:59 7acdc9265e994d72920b9642d72766c4 +msgid ":attr:`Pixmap.samples_ptr`" +msgstr "" + +#: ../../pixmap.rst:59 156a48e8f58c47e09ae568734cea15e7 +msgid "Python pointer to pixel area" +msgstr "" + +#: ../../pixmap.rst:60 84a8e1eedb634a72a577d1584e94d0a0 +msgid ":attr:`Pixmap.samples`" +msgstr "" + +#: ../../pixmap.rst:60 606142424b324dccb9f00c3a74ad6245 +msgid "`bytes` copy of pixel area" +msgstr "" + +#: ../../pixmap.rst:61 ac5abd1b5f7247d7a73ab0b75cac2ccd +msgid ":attr:`Pixmap.size`" +msgstr "" + +#: ../../pixmap.rst:61 2605193900774d809e5d92ddbd95a118 +msgid "pixmap's total length" +msgstr "" + +#: ../../pixmap.rst:62 011c516c715c45478d96b5844fb7935b +msgid ":attr:`Pixmap.stride`" +msgstr "" + +#: ../../pixmap.rst:62 d2234ee92ba84f98a712281b69005bfb +msgid "size of one image row" +msgstr "" + +#: ../../pixmap.rst:63 e7281b92e43e42f39867c25284c045ff +msgid ":attr:`Pixmap.width`" +msgstr "" + +#: ../../pixmap.rst:63 2429e2220bcf4e99afc7b3d78a26e08d +msgid "pixmap width" +msgstr "" + +#: ../../pixmap.rst:64 117793de58c54db89de20bfaa8420e3a +msgid ":attr:`Pixmap.x`" +msgstr "" + +#: ../../pixmap.rst:64 0c61458c88b440a597173e3ffac92fd2 +msgid "X-coordinate of top-left corner" +msgstr "" + +#: ../../pixmap.rst:65 30879c0d3b274120a9b46ce4f4986527 +msgid ":attr:`Pixmap.xres`" +msgstr "" + +#: ../../pixmap.rst:65 19b444a22b8945b79a9909a6765db83f +msgid "resolution in X-direction" +msgstr "" + +#: ../../pixmap.rst:66 304e847e1ff74eddbdde5716aa8c256e +msgid ":attr:`Pixmap.y`" +msgstr "" + +#: ../../pixmap.rst:66 35cc462e55ea483c8e573c94804a33cc +msgid "Y-coordinate of top-left corner" +msgstr "" + +#: ../../pixmap.rst:67 895b7bfddf44485e831c2d1b4d20915e +msgid ":attr:`Pixmap.yres`" +msgstr "" + +#: ../../pixmap.rst:67 0ba4603c678249bf971d67c7e2143a51 +msgid "resolution in Y-direction" +msgstr "" + +#: ../../pixmap.rst:70 7f11458661fd405b96408194a338f20e +msgid "**Class API**" +msgstr "" + +#: ../../pixmap.rst:76 a24ac9c296e9491bb67fa77c123b2b1c +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 "" + +#: ../../pixmap.rst 0a880bcf763041fdb266c73965139427 +#: 11f47556b8894408a8357aa423229344 17936988e7174de4a1abc109837fffcf +#: 23fd7c1b49a743b9ace61fa644724386 2cf1f10b2e3a4563ae200cb56815d8a6 +#: 2d0487959d3147faa48f09c099414811 30b0f29b277b4983829b84f80fa257bc +#: 504c24954087423ab63ea8da1d7c3919 5944dd39c8f94c47b9a0e876ff7400f4 +#: 7225fafa75344480b3b83ede66bf74f6 7bb4f807579242a99ee139f507376b91 +#: 7dd6ac30f61840588fa16c6ec5e01e86 81ba52d725124e9599ac448df3b4e882 +#: 84dc45a9155e4c9aa0e4471d00a2353e 84dfa3bfb9d3489d941af89f1f8d3552 +#: 856614d8ef7e40279f51e47a4bfedf2d 98c4c1b9e3e64ff1b1759852524d6135 +#: 9aa90f03ac394a5ab7610ff848a5a64c a9795cd8939a42cda8414de3f7f98935 +#: c5da3102bdf04bd7af775e72ddfa9fd5 d63b4e8498e74a6b8c0c72fa947e0713 +#: d975413dd0a44d97864daffcdb0bc94d e02b21b763c346fc9a0d68b4f720cc19 +#: e8cefb3c301b4dd3914bb2c108ec1f27 f07fd9f4b3de45ec92a2abdf95e4792c +#: f179316b14e240c196cd5c1f421e803c f8b80f0953dd484fa9f17752fd45e580 +msgid "Parameters" +msgstr "" + +#: ../../pixmap.rst:78 064a65669e6b44e2b53fc3a683c0f539 +msgid "colorspace." +msgstr "" + +#: ../../pixmap.rst:81 c8751e4ed126460a952007bb6d7f7818 +msgid "The pixmap's position and dimension." +msgstr "" + +#: ../../pixmap.rst:83 a8a8960a7c1549a6acaf8fde010780a8 +msgid "" +"Specifies whether transparency bytes should be included. Default is " +"*False*." +msgstr "" + +#: ../../pixmap.rst:87 184bec97cab04c31aa4bb2f52640a9d9 +msgid "" +"**Copy and set colorspace:** Copy *source* pixmap converting colorspace. " +"Any colorspace combination is possible, but source colorspace must not be" +" *None*." +msgstr "" + +#: ../../pixmap.rst:89 2a63915cc58b4cfbb2165bcd0b46e4e8 +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 "" + +#: ../../pixmap.rst:92 ../../pixmap.rst:111 a466035ae9294072a6dfe1de603c409c +#: a93d4ee271cd4e2eba39a66c50d9cf53 +msgid "the source pixmap." +msgstr "" + +#: ../../pixmap.rst:97 2a952f8fd32244b4858fbceb000556d1 +msgid "New in v1.18.18" +msgstr "" + +#: ../../pixmap.rst:99 3b669a37ad4446f3a06542bf8d32f9e2 +msgid "" +"**Copy and add image mask:** Copy *source* pixmap, add an alpha channel " +"with transparency data from a mask pixmap." +msgstr "" + +#: ../../pixmap.rst:101 d47b1627af0b439aae14b16bf978d875 +msgid "pixmap without alpha channel." +msgstr "" + +#: ../../pixmap.rst:104 1b8f034e48e64bc1879306b55a572c68 +msgid "a mask pixmap. Must be a graysale pixmap." +msgstr "" + +#: ../../pixmap.rst:109 80ed3606bc99407889ad8d16ac5424d7 +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 "" + +#: ../../pixmap.rst:114 340b2d5ce5a9458fbc5d98e015c4313f +msgid "desired target width." +msgstr "" + +#: ../../pixmap.rst:116 b66c25764d054cc78ad30a8352dda3d9 +msgid "desired target height." +msgstr "" + +#: ../../pixmap.rst:118 37e99a8051834962b899a11a80edcbd8 +msgid "restrict the resulting pixmap to this region of the **scaled** pixmap." +msgstr "" + +#: ../../pixmap.rst:120 7cff7e3600f848268dba53e19bce614f +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 "" + +#: ../../pixmap.rst:124 2a6423f660f9457aa3cd4a5c6ea2cd18 +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 "" + +#: ../../pixmap.rst:126 ../../pixmap.rst:304 4b141bf6909241a8a1f843c32fc8f380 +#: b8ddc919db904c7785ade88ea0fd9d84 +msgid "source pixmap." +msgstr "" + +#: ../../pixmap.rst:129 f7055367be624bba97850f015c647efc +msgid "" +"whether the target will have an alpha channel, default and mandatory if " +"source colorspace is *None*." +msgstr "" + +#: ../../pixmap.rst:131 aa26a517c15145fbbbdbfb39d4b8fb78 +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 "" + +#: ../../pixmap.rst:141 b4a745e34439469eae8f97ec011cbca9 +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.rst:143 3eb74b241bd245009aa456ae25d86bba +msgid "Path of the image file." +msgstr "" + +#: ../../pixmap.rst:147 ccdf984d350e421593fc31e2254395c3 +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.rst:149 ef17c235be70454cab8d59e16f2a51df +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:149 36776fd4749347308b1b2b421cc20655 +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 "" + +#: ../../pixmap.rst:151 d1b574f6b5764f0ab124c18804241f16 +msgid "*Changed in version 1.14.13:* *io.BytesIO* is now also supported." +msgstr "" + +#: ../../pixmap.rst:156 085f5efb0e054eb39d6d50dd59e72780 +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.rst:158 fc3a4ce3a7964c448e50d7c5e3625777 +msgid "Colorspace of image." +msgstr "" + +#: ../../pixmap.rst:161 f4653c39d5064dabbbf236194e23b1e4 +msgid "image width" +msgstr "" + +#: ../../pixmap.rst:163 18f104e5fe7c481c924ee4e9cb0ffb9a +msgid "image height" +msgstr "" + +#: ../../pixmap.rst:165 3f437e32022c465786250d146e5e74fa +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:165 d635d6cf078d40b3a616459c79903cfe +msgid "" +"an area containing all pixels of the image. Must include alpha values if " +"specified." +msgstr "" + +#: ../../pixmap.rst:167 9ebeb97aee494ddeab47c876c2117ec1 +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 "" + +#: ../../pixmap.rst:169 f7b665720a5e442f898c82eb7929b4dd +msgid "whether a transparency channel is included." +msgstr "" + +#: ../../pixmap.rst:173 8810448318ed495b84eff6f373fe531e +msgid "" +"The following equation **must be true**: *(colorspace.n + alpha) * width " +"* height == len(samples)*." +msgstr "" + +#: ../../pixmap.rst:174 380c5c20930f455fa4791a43571df273 +msgid "" +"Starting with version 1.14.13, the samples data are **copied** to the " +"pixmap." +msgstr "" + +#: ../../pixmap.rst:179 84767fdfbbea4f939cee2748783dc44e +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 "" + +#: ../../pixmap.rst:181 ca9978be74104008af0b46b15063a9e6 +msgid "an opened **PDF** document." +msgstr "" + +#: ../../pixmap.rst:184 827be000dcc343a6b5419fcd4dd5742f +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 "" + +#: ../../pixmap.rst:188 6d3742913f88465591c4b23ab2e61e3b +msgid "Initialize the samples area." +msgstr "" + +#: ../../pixmap.rst:190 f2c318813bed45499e63c70948c59eec +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 "" + +#: ../../pixmap.rst:192 4fe5d994e58244bda879631e6328b472 +msgid "" +"the area to be cleared. Omit to clear the whole pixmap. Can only be " +"specified, if *value* is also specified." +msgstr "" + +#: ../../pixmap.rst:196 370d483e43d741d388db61963481f12d +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 "" + +#: ../../pixmap.rst:198 5705d03d1c884f29ab2c7039b78bbe31 +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 "" + +#: ../../pixmap.rst:200 56efff12e47f4e90a17ae0b682f8848d +msgid "replace black with this value. Specifying 0x000000 makes no changes." +msgstr "" + +#: ../../pixmap.rst:201 2ae67910540b4e8d9f7c6daa83017baf +msgid "replace white with this value. Specifying 0xFFFFFF makes no changes." +msgstr "" + +#: ../../pixmap.rst:203 3dad2c074c414eacb754d59d1392c4d3 +msgid "Examples:" +msgstr "" + +#: ../../pixmap.rst:205 edb8e04c15804f9393ae9c077e7210f9 +msgid "`tint_with(0x000000, 0xFFFFFF)` is a no-op." +msgstr "" + +#: ../../pixmap.rst:206 6f36155938b14fe2845de75cb66711c9 +msgid "" +"`tint_with(0x00FF00, 0xFFFFFF)` changes black to green, leaves white " +"intact." +msgstr "" + +#: ../../pixmap.rst:207 a83b71968aad42f0826e9ebfca27c045 +msgid "`tint_with(0xFF0000, 0x0000FF)` changes black to red and white to blue." +msgstr "" + +#: ../../pixmap.rst:212 70a5c0eab0a74959bb3dbc030ff176f7 +msgid "" +"Apply a gamma factor to a pixmap, i.e. lighten or darken it. Pixmaps with" +" colorspace *None* are ignored with a warning." +msgstr "" + +#: ../../pixmap.rst:214 47f87befd4b047629d04de5e3671eb4f +msgid "" +"*gamma = 1.0* does nothing, *gamma < 1.0* lightens, *gamma > 1.0* darkens" +" the image." +msgstr "" + +#: ../../pixmap.rst:218 aa70d31e42d94127bfcb9c03d84653aa +msgid "Shrink the pixmap by dividing both, its width and height by 2\\ :sup:`n`." +msgstr "" + +#: ../../pixmap.rst:220 59b4f24ad8334c128f60d84d3b746070 +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.rst:222 1224e29f6f8b45ae8727e48dd64a0471 +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:226 873fd04197ec46d78b9eaf7193ca0dc8 +msgid "" +"*New in version:: 1.14.5:* Return the value of the pixel at location (x, " +"y) (column, line)." +msgstr "" + +#: ../../pixmap.rst:228 ../../pixmap.rst:238 2453fbadc0f9488392c88dc1440bcef8 +#: a2d8d5f362e34fd39293f859b38b9dfa +msgid "the column number of the pixel. Must be in `range(pix.width)`." +msgstr "" + +#: ../../pixmap.rst:229 3c7788e2ac804899b5f1427f4b766182 +msgid "the line number of the pixel, Must be in `range(pix.height)`." +msgstr "" + +#: ../../pixmap.rst 46366859f3a34e4ba4125c0e928fd199 +#: 57cab466063e43b2ae3cf55367fa5b81 5d88fbf694c34656b5ea10fb40a2dea8 +#: 85a7d49a9cc84c47b80320a0fe5b1208 9dd10afa3ad5443a9dd24246f67f6cea +#: bed184413efb46e9afcd472f44ec950a df2f950f77c0488891c21b7ad661e230 +msgid "Return type" +msgstr "" + +#: ../../pixmap.rst 1d31737d7ff444249b3d75ec520b58a8 +#: 20ca96e391444d068a4318614c18b912 429a92ea19dd435fbccc471e67bf50e6 +#: 5c6cfda653c14bea899ef4721198b67b b9965efd6e3b41d28fbfdc9919649385 +#: fefaf9c858a542d18a83d31fbc01e7d3 +msgid "Returns" +msgstr "" + +#: ../../pixmap.rst:232 826ee697738448799ee5e00c241988f6 +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.rst:236 1a7157bdc1ae4c5abdc406bac83dd884 +msgid "" +"*New in version 1.14.7:* Manipulate the pixel at location (x, y) (column," +" line)." +msgstr "" + +#: ../../pixmap.rst:239 c2fb3872e63f489f8ba044e338564d8e +msgid "the line number of the pixel. Must be in `range(pix.height)`." +msgstr "" + +#: ../../pixmap.rst:240 5048af0c514342a59ab848be24da61d3 +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 "" + +#: ../../pixmap.rst:244 6b11cb7cd1094833bdd0b44e5e4c27ba +msgid "*New in version 1.14.8:* Set the pixels of a rectangle to a value." +msgstr "" + +#: ../../pixmap.rst:246 ca59536a95584ec9a81bbf5b701a8089 +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 "" + +#: ../../pixmap.rst:247 0f751a337f8a4ed2aa5fc169c70159cf +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 "" + +#: ../../pixmap.rst:250 feb3dc6fa94b4248890164de0497e478 +msgid "" +"*False* if the rectangle was invalid or had an empty intersection with " +":attr:`Pixmap.irect`, else *True*." +msgstr "" + +#: ../../pixmap.rst:254 248628d37db9495f8e091288f1c58787 +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 "" + +#: ../../pixmap.rst:255 2bee4c0d335d4532af45f52fc9374640 +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 "" + +#: ../../pixmap.rst:259 e0dd27638e6b4006ad3a30f87b7163dd +msgid "New in v1.17.7" +msgstr "" + +#: ../../pixmap.rst:261 8ff3611af1584d478a9c3dfb41181902 +msgid "Set the x and y values of the pixmap's top-left point." +msgstr "" + +#: ../../pixmap.rst:263 7498b15546fd4c31987c155ea7a0ed8c +msgid "x coordinate" +msgstr "" + +#: ../../pixmap.rst:264 1386b752059042ac9ada41cd389e7c27 +msgid "y coordinate" +msgstr "" + +#: ../../pixmap.rst:269 c3b9887435564d4c96e6472962b47f56 +msgid "New in v1.16.17" +msgstr "" + +#: ../../pixmap.rst:271 02fa9d347ccb43e58f83a86e637b931c +msgid "" +"Changed in v1.18.0: When saving as a PNG image, these values will be " +"stored now." +msgstr "" + +#: ../../pixmap.rst:273 ce4c493b2e4045fca0b88216ceb93478 +msgid "Set the resolution (dpi) in x and y direction." +msgstr "" + +#: ../../pixmap.rst:275 84f536976ab74b20bc404077213f8d84 +msgid "resolution in x direction." +msgstr "" + +#: ../../pixmap.rst:276 51f6620230164421b691930cd3b149c5 +msgid "resolution in y direction." +msgstr "" + +#: ../../pixmap.rst:281 21b8089f8f7c4519ad284bb2e916e2ec +msgid "Changed in v 1.18.13" +msgstr "" + +#: ../../pixmap.rst:283 3b3c0b7d64ea48a8a5425a51758ea2d7 +msgid "Change the alpha values. The pixmap must have an alpha channel." +msgstr "" + +#: ../../pixmap.rst:285 5aa320a630c8442e9936ca1ec33b0d59 +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 "" + +#: ../../pixmap.rst:286 e736394102bd41139866fbe193828499 +msgid "" +"*New in v1.18.13:* whether to premultiply color components with the alpha" +" value." +msgstr "" + +#: ../../pixmap.rst:287 280db1e3d8f54e84a8adc8f07c19ab72 +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 "" + +#: ../../pixmap.rst:292 a0fe2cce4eda4fd0b1792fc41e626e08 +msgid "" +"Invert the color of all pixels in :ref:`IRect` *irect*. Will have no " +"effect if colorspace is *None*." +msgstr "" + +#: ../../pixmap.rst:294 56fed8bc0b10437183d30eeb3d1e94c7 +msgid "The area to be inverted. Omit to invert everything." +msgstr "" + +#: ../../pixmap.rst:298 0e2654b922fb4806bf5986c885399ca3 +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 "" + +#: ../../pixmap.rst:300 a3e3996a2b86468781b3f6fee72d6d29 +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 "" + +#: ../../pixmap.rst:302 d2ba7c6c01054a18a23e237f11532e24 +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 "" + +#: ../../pixmap.rst:307 08638c1d64f443f5b78bbf9cf765f869 +msgid "The area to be copied." +msgstr "" + +#: ../../pixmap.rst:309 5ef2a064e36e42e7a80cb5a0b04e08e3 +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 "" + +#: ../../pixmap.rst:328 d5a1d72cde574e7d9d07ced44cd4e702 +msgid "" +"Changed in v1.22.0: Added **direct support of JPEG** images. Image " +"quality can be controlled via parameter \"jpg_quality\"." +msgstr "" + +#: ../../pixmap.rst:330 5c631fba1ed2488c88a153c911c2aa6c +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:332 651466b92c794016b9117134d479fc6f +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 "" + +#: ../../pixmap.rst:334 8d331d9afa444ecf81c420e143e92391 +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 "" + +#: ../../pixmap.rst:335 ../../pixmap.rst:345 cd36a6f571b64c9db336a49e0979293b +#: fca2473cca5c4900bc182b9862c80b33 +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 "" + +#: ../../pixmap.rst 57643f99dfa64104a4642d76b4cacb86 +#: ac6af469ef4b4645a97b50290fb508b5 f30abe19c97f449bbcc7af9bbaa19100 +msgid "Raises" +msgstr "" + +#: ../../pixmap.rst:337 ../../pixmap.rst:347 1ebaaad1d343402daa8b5019b96d0a5f +#: d5e0834015b147d9a5f1cb6ea41fe4d2 +msgid "For unsupported image formats." +msgstr "" + +#: ../../pixmap.rst:341 b5d9f3584d7642638d9d3b940de14165 +msgid "" +"New in version 1.14.5: Return the pixmap as a *bytes* memory object of " +"the specified format -- similar to :meth:`save`." +msgstr "" + +#: ../../pixmap.rst:342 fae5acbde4764765a1b3756604e86b90 +msgid "" +"Changed in v1.22.0: Added **direct JPEG support**. Image quality can be " +"influenced via new parameter \"jpg_quality\"." +msgstr "" + +#: ../../pixmap.rst:344 51c5d62d78e847ea926a5f2e45e73d1c +msgid "" +"The desired image format. The default is \"png\". For possible values see" +" :ref:`PixmapOutput`." +msgstr "" + +#: ../../pixmap.rst:350 1f6c26463c1d4d4b8842dcdf4f5b7265 +msgid "" +"The requested image format. The default is \"png\". For other possible " +"values see :ref:`PixmapOutput`." +msgstr "" + +#: ../../pixmap.rst:354 ../../pixmap.rst:369 936b8a9f05744fabbc94bbce0c23d571 +#: 93bf4571b79f4021a2321d712668d732 +msgid "New in v1.19.0" +msgstr "" + +#: ../../pixmap.rst:356 ../../pixmap.rst:371 9214c38fd62148f78a029785762d6ce9 +#: b52b08815e88423b918349ac3116270e +msgid "Changed in v1.22.5: Support of new parameter for Tesseract's tessdata." +msgstr "" + +#: ../../pixmap.rst:358 8200633ea88941a19673bd66b815ec70 +msgid "" +"Perform text recognition using Tesseract and save the image as a 1-page " +"PDF with an OCR text layer." +msgstr "" + +#: ../../pixmap.rst:360 b85cfde5e3a249bd94a7f7c5b17a3d55 +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 "" + +#: ../../pixmap.rst:361 795b63cd08184dad9378dd934546ff75 +msgid "whether to compress the resulting PDF, default is `True`." +msgstr "" + +#: ../../pixmap.rst:362 062741c685c54342bce832dc3c4b9ded +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 "" + +#: ../../pixmap.rst:363 8ce79a8b26a8442b89970bf89d72b891 +msgid "" +": arg str tessdata: folder name of Tesseract's language support. If " +"omitted, this information must be present as environment variable " +"`TESSDATA_PREFIX`." +msgstr "" + +#: ../../pixmap.rst:365 fb1e5feb32e54bb98beafbd508b317b5 +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 "" + +#: ../../pixmap.rst:373 154fa7110f634c589b73a46d6f65fd58 +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 "" + +#: ../../pixmap.rst:375 16969d0cdc024129aab7f307b6f01e6a +msgid "" +"A 1-page PDF file in memory. Could be opened like `doc=fitz.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 = " +"fitz.open() for imgfile in os.listdir(folder): pix = " +"fitz.Pixmap(imgfile) imgpdf = fitz.open(\"pdf\", " +"pix.pdfocr_tobytes()) doc.insert_pdf(imgpdf) pix = None" +" imgpdf.close() doc.save(\"ocr-images.pdf\")" +msgstr "" + +#: ../../pixmap.rst:375 3ed27d1cebe84d4dba2dc698416200e9 +msgid "" +"A 1-page PDF file in memory. Could be opened like `doc=fitz.open(\"pdf\"," +" pix.pdfocr_tobytes())`, and text extractions could be performed on its " +"`page=doc[0]`." +msgstr "" + +#: ../../pixmap.rst:379 630cdd9208d24d47b536b01f210ea1f2 +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 "" + +#: ../../pixmap.rst:393 ../../pixmap.rst:409 4260364b4a0a44ee9ab24ecaf3cad73e +#: 82969bfe514143b5abe62f5097426b22 +msgid "New in v1.17.3" +msgstr "" + +#: ../../pixmap.rst:395 f3fdfbb0666240d0949f5ac64000acc1 +msgid "" +"Write the pixmap as an image file using Pillow. Use this method for " +"output unsupported by MuPDF. Examples are" +msgstr "" + +#: ../../pixmap.rst:397 c87d172fb1824a43a9ef1aa0395c5e5e +msgid "Formats JPX, J2K, WebP, etc." +msgstr "" + +#: ../../pixmap.rst:398 97e9bd6817064ebcb1403b084229aa76 +msgid "Storing EXIF information." +msgstr "" + +#: ../../pixmap.rst:399 b91ed39b2374483ab88d91a5dad1fa41 +msgid "" +"If you do not provide dpi information, the values *xres*, *yres* stored " +"with the pixmap are automatically used." +msgstr "" + +#: ../../pixmap.rst:401 776bbcce7af44e71ba4c56ba29233573 +msgid "" +"A simple example: `pix.pil_save(\"some.webp\", optimize=True, dpi=(150, " +"150))`. For details on other parameters see the Pillow documentation." +msgstr "" + +#: ../../pixmap.rst:403 2bbbe8ed703544e9939e0992c7aa1c6a +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 "" + +#: ../../pixmap.rst:405 4fd44f4fa03c453a9379b4840336bc1d +msgid "if Pillow is not installed." +msgstr "" + +#: ../../pixmap.rst:411 137b22b0d3d34f93b9065816beec51c5 +msgid "" +"Return an image as a bytes object in the specified format using Pillow. " +"For example `stream = pix.pil_tobytes(format=\"WEBP\", optimize=True)`. " +"Also see above. For details on other parameters see the Pillow " +"documentation." +msgstr "" + +#: ../../pixmap.rst:413 760323fbc70341aeb39670c9cf2d1866 +msgid ".raises ImportError: if Pillow is not installed." +msgstr "" + +#: ../../pixmap.rst:420 ../../pixmap.rst:455 073bc0266e4b47169f2a52b8354f0316 +#: 12f0004f003445b18924b5bc6ffa97a3 +msgid "New in v1.19.3" +msgstr "" + +#: ../../pixmap.rst:422 abcbb3ae39fc40ddbfea4641810d9aa3 +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.rst:424 b22526a9bb81499cb0d5afa643015b89 +msgid "" +"a convex quad with coordinates inside :attr:`Pixmap.irect` (including the" +" border points)." +msgstr "" + +#: ../../pixmap.rst:425 91d72b06b34746fdbecee054783f656c +msgid "desired resulting width." +msgstr "" + +#: ../../pixmap.rst:426 2c1757c0e2e84606b9ecaab631fcde58 +msgid "desired resulting height." +msgstr "" + +#: ../../pixmap.rst:427 c8509f2b8e9b4539a592b9417e32b05c +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 "" + +#: ../../pixmap.rst:428 1fd2ae015351496794fcdf592ca251c0 +msgid "" +":ref:`Pixmap` .. image:: images/img-warp.* :scale: 40 :align: " +"center" +msgstr "" + +#: ../../pixmap.rst:428 16f127abe7b549e2b561b0988d78adc9 +msgid ":ref:`Pixmap`" +msgstr "" + +#: ../../pixmap.rst:437 ../../pixmap.rst:494 ../../pixmap.rst:503 +#: 9b47089d994e447989685c801141c48a c318fca9678e435990fed68159909fa8 +#: e6b0ef32aae94756b7664497a9919cd0 +msgid "New in v1.19.2" +msgstr "" + +#: ../../pixmap.rst:438 8df80b91bfd749be8630f0558464bd37 +msgid "Changed in v1.19.3" +msgstr "" + +#: ../../pixmap.rst:440 26baa300d00244348d0e9838ceb9fb3b +msgid "Determine the pixmap's unique colors and their count." +msgstr "" + +#: ../../pixmap.rst:442 c478eef26090401abc2ed9f6148fbbde +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 "" + +#: ../../pixmap.rst:443 e4e954bb8fbd4ca387b6339e7bb247c1 +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 "" + +#: ../../pixmap.rst:445 7c22f479504142fb846c83fa0c47be1a +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:445 c0e2e7db5e484671b36b6131bab8f8c4 +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 "" + +#: ../../pixmap.rst:447 f219e4bc54434cdb9405ddace2d86791 +msgid "" +"To recover the **tuple** of a pixel, use `tuple(colors.keys()[i])` for " +"the i-th item." +msgstr "" + +#: ../../pixmap.rst:449 0e8322c8418f48fa8425d996d7d28941 +msgid "" +"The response time depends on the pixmap's samples size and may be more " +"than a second for very large pixmaps." +msgstr "" + +#: ../../pixmap.rst:450 3567f15741164ba6a629b3987b3cc8fc +msgid "" +"Where applicable, pixels with different alpha values will be treated as " +"different colors." +msgstr "" + +#: ../../pixmap.rst:457 005f7aa0f04f4fc3a8dad0d612fd2987 +msgid "Return the most frequently used color and its relative frequency." +msgstr "" + +#: ../../pixmap.rst:459 a4f104575eac49df93dbd614b75f07da +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 "" + +#: ../../pixmap.rst:461 6568af8783124b51877459b5618f637e +#, 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 "" + +#: ../../pixmap.rst:466 2ecfd01a95ea42939b628b7410738eb7 +msgid "Indicates whether the pixmap contains transparency information." +msgstr "" + +#: ../../pixmap.rst 0022c9062b0b4eb390a723ac66ecf2fc +#: 0095effd439b4a5f88d181e28771aafc 13bcf2ca86a74edfb2acaef4fb1b371e +#: 2312dbf2719c4a6d844e3bc61882530f 30092c5dbbc4409796152199582553a5 +#: 40086e43f9474c5d9307d2819576d2cb 40d8bb824b36486e8f6bcb453e2fc282 +#: 480635f3302e4d30a56563576e377072 495b7013219c48c8ade84c3b96caf993 +#: 6106f67425f7490ca1f1ab79767844de 756da6557f9c4237a12173f02643c6f5 +#: 77cb33603b744b0083ea7811e1d438e1 860a6e5cd12f4f739274ef5f835c3774 +#: 9708505f28b149bfa61d6e1c5df18c7e abf694e662d94ae69e721cbfcd50a110 +#: b014588eeea240aebc7b6b2349cae38e bf47da62029740d28181cf8c6b2a8d1f +#: d3e02d7735a14036b69b9e33f551a645 f453f68809f84ad99aa4a8a0ff62c3dd +msgid "type" +msgstr "" + +#: ../../pixmap.rst:468 ../../pixmap.rst:498 ../../pixmap.rst:507 +#: ../../pixmap.rst:616 1afb4f9a2b994c099142d49f49b44b13 +#: 1afbaef589e14c9d94ebc84f502f6e46 a02aebd121dc4ccca67770c4260d0552 +#: ca0a96cbc178462ba289d35e80930357 +msgid "bool" +msgstr "" + +#: ../../pixmap.rst:472 d92c96d8ac854e5ebc9998898ddb6ea3 +msgid "" +"The MD5 hashcode (16 bytes) of the pixmap. This is a technical value used" +" for unique identifications." +msgstr "" + +#: ../../pixmap.rst:474 ../../pixmap.rst:526 651aa8348eab4f30b78079528a1cc728 +#: eb2c33317479486b96046bc4d111adb5 +msgid "bytes" +msgstr "" + +#: ../../pixmap.rst:478 ab816c38d60c44f6b3a647247ed51f1f +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.rst:480 e14dcc74e5694b2cbd480efaf755a1bf +msgid ":ref:`Colorspace`" +msgstr "" + +#: ../../pixmap.rst:484 947e2d3ddecc446687ae85836aabcd1e +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 "" + +#: ../../pixmap.rst:486 07085956598f476ebbb7bb73b8ba17ae +msgid "`len(samples) == height * stride`" +msgstr "" + +#: ../../pixmap.rst:487 90622f721998453198932f4b9e0983e4 +msgid "`width * n == stride`" +msgstr "" + +#: ../../pixmap.rst:489 ../../pixmap.rst:558 ../../pixmap.rst:564 +#: ../../pixmap.rst:572 ../../pixmap.rst:580 ../../pixmap.rst:586 +#: ../../pixmap.rst:592 ../../pixmap.rst:598 ../../pixmap.rst:604 +#: ../../pixmap.rst:610 15ddc796bd4b45a384ab4464c2dbd409 +#: 2c475befc49e489dbd0561c1a8364b8e 76b7002169504fe4b605fcc61f463e89 +#: 957cb6e3d6c84904a958ab5811a6d1d2 b2168978f2c34b4fa88b03a75f43ee42 +#: d7d9f07320d940e6b3ac7895a6249668 e1c7e577a8414ef192849c80c4d473cd +#: eafee96ed01d4a0d963c1254f72766b4 ed02b97a95374be4ad31fd0fc04b6dbd +#: f6f842966f6346058292f78d0f5defd3 +msgid "int" +msgstr "" + +#: ../../pixmap.rst:496 22aebbae5b314644b5992d6c51e21c91 +msgid "Is `True` for a gray pixmap which only has the colors black and white." +msgstr "" + +#: ../../pixmap.rst:505 f7adbde4348245f4a55885f0f13a6c46 +msgid "" +"Is `True` if all pixels are identical (any colorspace). Where applicable," +" pixels with different alpha values will be treated as different colors." +msgstr "" + +#: ../../pixmap.rst:512 29614ffce0284c8d9f7654c136b262f5 +msgid "Contains the :ref:`IRect` of the pixmap." +msgstr "" + +#: ../../pixmap.rst:514 a16afdc8997d402b89846cf221ebda15 +msgid ":ref:`IRect`" +msgstr "" + +#: ../../pixmap.rst:518 d5da17312980404da934be56a9518def +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 "" + +#: ../../pixmap.rst:520 18a02d532b0b40228d663594a0ef8313 +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 "" + +#: ../../pixmap.rst:523 1499f26f5d3d4164a00a866f97faf8d7 +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 "" + +#: ../../pixmap.rst:524 dd7ee26768a34209b31b58883705594a +msgid "" +"Any changes to the underlying data are available only after accessing " +"this attribute again. This is different from using the memoryview " +"version." +msgstr "" + +#: ../../pixmap.rst:530 ../../pixmap.rst:549 00bcb9dcbceb4273b8186532d5b08492 +#: a74b4174b47044f6929d20f8e0eebfb0 +msgid "New in v1.18.17" +msgstr "" + +#: ../../pixmap.rst:532 f32b9190db2640f3a55be8268f62d5c2 +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 "" + +#: ../../pixmap.rst:534 88fa5930f4a84af8a85adf6aef9ada97 +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 "" + +#: ../../pixmap.rst:536 92e6d9173b1842f084e13916e4beb255 +msgid "We also have `len(pix.samples) == len(pix.samples_mv)`." +msgstr "" + +#: ../../pixmap.rst:538 16fcb81af50a427e9b6bb5ae3207b050 +msgid "" +"Look at this example from a 2 MB JPEG: the memoryview is **ten thousand " +"times faster**::" +msgstr "" + +#: ../../pixmap.rst:545 7580aefe1dd941dfa4ca50196b464e00 +msgid "memoryview" +msgstr "" + +#: ../../pixmap.rst:551 f07985fa9d184cb09b330658fc8710f4 +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 "" + +#: ../../pixmap.rst:556 98fc9876b0bd469ea243e90e2df83589 +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 "" + +#: ../../pixmap.rst:562 589f36b16c0e4486ad824cceebb1f094 +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.rst:570 46ac69a80e2a4bb79ffef7b05961d211 +msgid "Width of the region in pixels." +msgstr "" + +#: ../../pixmap.rst:578 1a2405b70da9443aa924946735a3c955 +msgid "Height of the region in pixels." +msgstr "" + +#: ../../pixmap.rst:584 ea3ff64357ad4cebadfca178bd7ab852 +msgid "" +"X-coordinate of top-left corner in pixels. Cannot directly be changed -- " +"use :meth:`Pixmap.set_origin`." +msgstr "" + +#: ../../pixmap.rst:590 ce5e1a55c052492e82e92a5e55a15ee0 +msgid "" +"Y-coordinate of top-left corner in pixels. Cannot directly be changed -- " +"use :meth:`Pixmap.set_origin`." +msgstr "" + +#: ../../pixmap.rst:596 2561a58720d540a488e92e3e0fffc882 +msgid "" +"Number of components per pixel. This number depends on colorspace and " +"alpha. If colorspace is not *None* (stencil masks), then *Pixmap.n - " +"Pixmap.aslpha == pixmap.colorspace.n* is true. If colorspace is *None*, " +"then *n == alpha == 1*." +msgstr "" + +#: ../../pixmap.rst:602 a04f7c624794476dada5aaef455a59c4 +msgid "" +"Horizontal resolution in dpi (dots per inch). Please also see " +":data:`resolution`. Cannot directly be changed -- use " +":meth:`Pixmap.set_dpi`." +msgstr "" + +#: ../../pixmap.rst:608 12073c23495147e6abb26fe5bdd1bc02 +msgid "" +"Vertical resolution in dpi (dots per inch). Please also see " +":data:`resolution`. Cannot directly be changed -- use " +":meth:`Pixmap.set_dpi`." +msgstr "" + +#: ../../pixmap.rst:614 c65a077618204cc093f3f21492ce2056 +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 "" + +#: ../../pixmap.rst:621 f206f9edfcb2414f94d70ae5277d41ea +msgid "Supported Input Image Formats" +msgstr "" + +#: ../../pixmap.rst:622 27aa25d3ca2d47d990aded430bb7ca90 +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 "" + +#: ../../pixmap.rst:624 518f02c5a7964e0880697911fb2faadc +msgid "" +"Directly create a pixmap with *Pixmap(filename)* or *Pixmap(byterray)*. " +"The pixmap will then have properties as determined by the image." +msgstr "" + +#: ../../pixmap.rst:626 f9ee9030f7fb49fe98358280eb7561c9 +msgid "" +"Open such files with *fitz.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 "" + +#: ../../pixmap.rst:628 3b8791aa28d2483abbb5203ff09bbb5d +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 "" + +#: ../../pixmap.rst:633 c29caf6918a4475eb1906939ca651d1e +msgid "Supported Output Image Formats" +msgstr "" + +#: ../../pixmap.rst:634 acd888be885d4812a14c68623dbe5c8f +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 "" + +#: ../../pixmap.rst:637 7fb740a0794c403993319a643eb38db6 +msgid "**Format**" +msgstr "" + +#: ../../pixmap.rst:637 0aa0951203e3498ca5a4d2e5a0899989 +msgid "**Colorspaces**" +msgstr "" + +#: ../../pixmap.rst:637 fad7f4e526ad4cf9a73c4d444bdf4a1d +msgid "**alpha**" +msgstr "" + +#: ../../pixmap.rst:637 1c74f7bebc6747239ff279ae592175ba +msgid "**Extensions**" +msgstr "" + +#: ../../pixmap.rst:637 8617b15a52ee44769328a477b025db1c +msgid "**Description**" +msgstr "" + +#: ../../pixmap.rst:639 8f783c7ed82240beb359f2f601484542 +msgid "jpg, jpeg" +msgstr "" + +#: ../../pixmap.rst:639 ../../pixmap.rst:640 ../../pixmap.rst:646 +#: ../../pixmap.rst:647 0176a51ef48d4f9f9f955f31b997e02e +#: 128ade783c17473faf2f57e4455e2d5e a0a169d07f154079afd3406388a9c6d7 +#: b22af49074ad445d98ae4c1813519293 +msgid "gray, rgb, cmyk" +msgstr "" + +#: ../../pixmap.rst:639 ../../pixmap.rst:641 ../../pixmap.rst:642 +#: ../../pixmap.rst:644 ../../pixmap.rst:645 ../../pixmap.rst:646 +#: 2d6c18f416bd4ead9fb4eb5bcde4c42a 3ea2db7bba1544bb91824a07d11ef718 +#: 7b9acca96e5b4608a07427d445521acf c088e9ac65174aa7a23ef3e12d155f4e +#: d3e2ddf7a974454fa9f9b4dbb492a72b e6afaa796fea414ea97053bbade4bd06 +msgid "no" +msgstr "" + +#: ../../pixmap.rst:639 7de83c3d9e5a486a8b59d1e27f9b2dee +msgid ".jpg, .jpeg" +msgstr "" + +#: ../../pixmap.rst:639 0416ddb34dc84168bd3e3a045ae69a64 +msgid "Joint Photographic Experts Group" +msgstr "" + +#: ../../pixmap.rst:640 36a8b4641b0d4a378c0a6974e97fd8e4 +msgid "pam" +msgstr "" + +#: ../../pixmap.rst:640 ../../pixmap.rst:643 ../../pixmap.rst:647 +#: 3a3289848bce4611a48a877a9a6568f9 9cff5fa8962441f7908bbd3d9b7a6780 +#: a18c35d143c140fcb2643aca4853c4da +msgid "yes" +msgstr "" + +#: ../../pixmap.rst:640 11a029521e3e45408487750140b4a8b0 +msgid ".pam" +msgstr "" + +#: ../../pixmap.rst:640 0668ee1679a34964bf3bddcd40e66539 +msgid "Portable Arbitrary Map" +msgstr "" + +#: ../../pixmap.rst:641 9f4ed11fea76435581c4c4af6c6b8440 +msgid "pbm" +msgstr "" + +#: ../../pixmap.rst:641 ../../pixmap.rst:642 ../../pixmap.rst:643 +#: ../../pixmap.rst:644 ../../pixmap.rst:645 31334845801845fea0414530101d7b83 +#: 5b1b8f0ceb8a45b0b51f7f2982c57f4f 947056c4607a4990a3208acd510da916 +#: 9d26e3dd474e4aeda83ecfb41abf82ae f2728b3ded0043f987c0a84247d14c83 +msgid "gray, rgb" +msgstr "" + +#: ../../pixmap.rst:641 f5bc6ed67218451196a7444afbc026c6 +msgid ".pbm" +msgstr "" + +#: ../../pixmap.rst:641 70bdcb624fb04370b9e511e61557dff6 +msgid "Portable Bitmap" +msgstr "" + +#: ../../pixmap.rst:642 5867d66be47b46ff9104c451d5bc5b17 +msgid "pgm" +msgstr "" + +#: ../../pixmap.rst:642 8f48fad0481c43538b5f985ca6c0f7fc +msgid ".pgm" +msgstr "" + +#: ../../pixmap.rst:642 1eea086b51e8434aac8c1166120b41c4 +msgid "Portable Graymap" +msgstr "" + +#: ../../pixmap.rst:643 c450b40cb3534979bc4bb2c1cbc0bbc0 +msgid "png" +msgstr "" + +#: ../../pixmap.rst:643 acfe1cd2f3f247ec8c599cf7e04ec855 +msgid ".png" +msgstr "" + +#: ../../pixmap.rst:643 2704698c70f0483ab386cb21b21f305e +msgid "Portable Network Graphics" +msgstr "" + +#: ../../pixmap.rst:644 90896202d175488a8ec1e04e7ada50a3 +msgid "pnm" +msgstr "" + +#: ../../pixmap.rst:644 500726ceae9d40878b5de653ba2ee59c +msgid ".pnm" +msgstr "" + +#: ../../pixmap.rst:644 e186d78830d845b2ad958c57b8c53ea1 +msgid "Portable Anymap" +msgstr "" + +#: ../../pixmap.rst:645 2d672261304b4d00b555e87a6302b8ef +msgid "ppm" +msgstr "" + +#: ../../pixmap.rst:645 6b9ca345f4d0412a9cfea39b40825dc8 +msgid ".ppm" +msgstr "" + +#: ../../pixmap.rst:645 36a1f65c4f0e4b81b0f665ce0c84a26d +msgid "Portable Pixmap" +msgstr "" + +#: ../../pixmap.rst:646 7034a050bbb54fc4aa01e9fa73bb1951 +msgid "ps" +msgstr "" + +#: ../../pixmap.rst:646 b8581e62289e45f0b9f4539660661a2c +msgid ".ps" +msgstr "" + +#: ../../pixmap.rst:646 8293e481f0904a84b6e7ac693dc7e426 +msgid "Adobe PostScript Image" +msgstr "" + +#: ../../pixmap.rst:647 7dbc3d66e3da4a2ca40d858820e1c70c +msgid "psd" +msgstr "" + +#: ../../pixmap.rst:647 fabced113752496f90eb9bc76e8abecd +msgid ".psd" +msgstr "" + +#: ../../pixmap.rst:647 033be85f1aa54d82b09394366340b604 +msgid "Adobe Photoshop Document" +msgstr "" + +#: ../../pixmap.rst:651 17af8801059545baaaba38fde5055ea8 +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 "" + +#: ../../pixmap.rst:652 9e20e010931d4185a5999b1eebbd0389 +msgid "" +"Especially pertaining to CMYK colorspaces, you can always convert a CMYK " +"pixmap to an RGB pixmap with *rgb_pix = fitz.Pixmap(fitz.csRGB, " +"cmyk_pix)* and then save that in the desired format." +msgstr "" + +#: ../../pixmap.rst:653 3b413ac8bda540ff9e15a42b541be998 +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 "" + +#: ../../pixmap.rst:654 d83312b2961a4c33aa9b161f30ab57a9 +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 "" + +#: ../../pixmap.rst:659 e38e1fe688d745f5b2f55898ecd85dbc +msgid "Footnotes" +msgstr "" + +#: ../../pixmap.rst:660 08c41850d56b450dbca1ba5918a2ccbb +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 "" + +#: ../../pixmap.rst:662 a196ec0d854249c98b87bf3d9fae5a1d +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:-1 d6930d5a24954fc9b3ee9c58c147d0d2 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/point.mo b/docs/locales/ja/LC_MESSAGES/point.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/point.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/point.po b/docs/locales/ja/LC_MESSAGES/point.po new file mode 100644 index 000000000..761a4c30d --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/point.po @@ -0,0 +1,251 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../point.rst:7 e0bcd881e305493bbe145a656518bbd5 +msgid "Point" +msgstr "" + +#: ../../point.rst:9 787f97b9babb43f8aeeabbc0b1903b44 +msgid "" +"*Point* represents a point in the plane, defined by its x and y " +"coordinates." +msgstr "" + +#: ../../point.rst:12 f017d58332304a43b94ca31aec1c1c25 +msgid "**Attribute / Method**" +msgstr "" + +#: ../../point.rst:12 d6efac4674304c46a4dd431ef8a45cad +msgid "**Description**" +msgstr "" + +#: ../../point.rst:14 2e3afc29e7a249ebb6423fc8fd0a1e28 +msgid ":meth:`Point.distance_to`" +msgstr "" + +#: ../../point.rst:14 339925f57d6f4c428b9d87d3dcea04f5 +msgid "calculate distance to point or rect" +msgstr "" + +#: ../../point.rst:15 cb2fbbb7d676439e8a232e6a0d3f7345 +msgid ":meth:`Point.norm`" +msgstr "" + +#: ../../point.rst:15 1814dd78fb3a4baabfeda0a101006957 +msgid "the Euclidean norm" +msgstr "" + +#: ../../point.rst:16 c78ce3df47d449068b189e0750ac0d20 +msgid ":meth:`Point.transform`" +msgstr "" + +#: ../../point.rst:16 ed12d350acbc4b8e99c60233acca2d66 +msgid "transform point with a matrix" +msgstr "" + +#: ../../point.rst:17 713e14c493cd464e9cede1f953e21c3c +msgid ":attr:`Point.abs_unit`" +msgstr "" + +#: ../../point.rst:17 4d970716a04b42909802ba4c6cfeae0a +msgid "same as unit, but positive coordinates" +msgstr "" + +#: ../../point.rst:18 deb488abffb345569fef0bf4460ac49c +msgid ":attr:`Point.unit`" +msgstr "" + +#: ../../point.rst:18 40da846d343b4c6592ff8e340b021e08 +msgid "point coordinates divided by *abs(point)*" +msgstr "" + +#: ../../point.rst:19 ddeee3aae059436fb829a8f6958614de +msgid ":attr:`Point.x`" +msgstr "" + +#: ../../point.rst:19 206c2a3ebbad43c2a0f81570c4ba5990 +msgid "the X-coordinate" +msgstr "" + +#: ../../point.rst:20 6af6b5cd51894aa480f018d7ff012945 +msgid ":attr:`Point.y`" +msgstr "" + +#: ../../point.rst:20 7854cade699b42c192c9b25faa6cc877 +msgid "the Y-coordinate" +msgstr "" + +#: ../../point.rst:23 93d7f1e35bfb4169ac916cf54095b61f +msgid "**Class API**" +msgstr "" + +#: ../../point.rst:35 13036f6f1956428cb87150c852556f3d +msgid "Overloaded constructors." +msgstr "" + +#: ../../point.rst:37 1c303c3b5c1a4f2488481101f2fd907e +msgid "Without parameters, *Point(0, 0)* will be created." +msgstr "" + +#: ../../point.rst:39 6b5e4769c72446b0958f93e9229a9ad4 +msgid "" +"With another point specified, a **new copy** will be created, " +"\"sequence\" is a Python sequence of 2 numbers (see " +":ref:`SequenceTypes`)." +msgstr "" + +#: ../../point.rst 138e867f2d634bdcbe20f4d2f30d91d4 +#: 4f72c20cbf844e558c86a428f0af9eec e2f83f73f43a42b58ebda2bd5e3af83a +msgid "Parameters" +msgstr "" + +#: ../../point.rst:41 534cd91aed904a93a530a244a89a6bd9 +msgid "x coordinate of the point" +msgstr "" + +#: ../../point.rst:43 7a3350a0940647e6aae89279473b3a92 +msgid "y coordinate of the point" +msgstr "" + +#: ../../point.rst:47 e3f56e260f5548acac5f398616a645cf +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 "" + +#: ../../point.rst:49 caa716fccbb04c278cb9114d49b6044d +msgid "to which to compute the distance." +msgstr "" + +#: ../../point.rst:51 9f08bd1a75ce4b0bbae9f1092edd1e2e +msgid "the unit to be measured in. One of \"px\", \"in\", \"cm\", \"mm\"." +msgstr "" + +#: ../../point.rst 1efc3a87fa104255a0b4da2e903d2b1a +#: c8aa18f75c034b7db2732c55e0a5fc47 +msgid "Return type" +msgstr "" + +#: ../../point.rst 3740dc05403d472c8b7ac68a6ca08fa2 +msgid "Returns" +msgstr "" + +#: ../../point.rst:54 8748b4529ebe4d3eb56cea689c432fd5 +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 1d883f5f4c7e4d828de6e445c1504854 +msgid "the distance to *x*. If this is :data:`rect_like`, then the distance" +msgstr "" + +#: ../../point.rst:56 190c4d8576504ba2a3ffccbe6f5e225e +msgid "" +"is the length of the shortest line connecting to one of the rectangle " +"sides" +msgstr "" + +#: ../../point.rst:57 a25ec015190f49f690af2a00ca34111a +msgid "is calculated to the **finite version** of it" +msgstr "" + +#: ../../point.rst:58 26c264e5dccb4e6abe7b34f16a2a6267 +msgid "is zero if it **contains** the point" +msgstr "" + +#: ../../point.rst:62 d1fce3f977334a679c752331662c775a +msgid "New in version 1.16.0" +msgstr "" + +#: ../../point.rst:64 65bd1cb70b9d4ad0b32797912cb42402 +msgid "" +"Return the Euclidean norm (the length) of the point as a vector. Equals " +"result of function *abs()*." +msgstr "" + +#: ../../point.rst:68 a325fe60009249cb876b73aafc6828a4 +msgid "Apply a matrix to the point and replace it with the result." +msgstr "" + +#: ../../point.rst:70 2fb3781079684f16b6e3cc6c8a98cb87 +msgid "The matrix to be applied." +msgstr "" + +#: ../../point.rst:72 ../../point.rst:80 ../../point.rst:86 +#: 52a620715c25480dbe8441571046e7a4 ba9672aec77448eebab6fa124c6d1dcd +#: e8ec389c074a4b868d48592af5432191 +msgid ":ref:`Point`" +msgstr "" + +#: ../../point.rst:76 be068d0bb9564bd6b115a53a572f777a +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 "" + +#: ../../point.rst 0a9d21441ad44147ae3d7e8643120c08 +#: 26411ca7ecbf4648b7358884688e0d02 8d9b6b03f74f41049de620ae8bea7dc1 +#: ff140813dcb141d59fe32ee9767a84c3 +msgid "type" +msgstr "" + +#: ../../point.rst:84 4da50404324e4ddea763162ba7346871 +msgid "" +"Same as :attr:`unit` above, replacing the coordinates with their absolute" +" values." +msgstr "" + +#: ../../point.rst:90 e402a09b7bb74ebbbff7c5e07ad2f4a5 +msgid "The x coordinate" +msgstr "" + +#: ../../point.rst:92 ../../point.rst:98 0e84c1e96468471288308c93cca448dd +#: c1855e8ecbbc42fd9632df4d760eb937 +msgid "float" +msgstr "" + +#: ../../point.rst:96 324ff8c9d3e84097a7fd381b3a7cf50e +msgid "The y coordinate" +msgstr "" + +#: ../../point.rst:102 b79e714a357749f9bb75d0fe96a9150e +msgid "" +"This class adheres to the Python sequence protocol, so components can be " +"accessed via their index, too. Also refer to :ref:`SequenceTypes`." +msgstr "" + +#: ../../point.rst:103 2b21007dde0f46b689915a4f3dd4452c +msgid "" +"Rectangles can be used with arithmetic operators -- see chapter " +":ref:`Algebra`." +msgstr "" + +#: ../../footer.rst:-1 a9df7f8109ee4edfbf63647b0500f2a0 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/quad.mo b/docs/locales/ja/LC_MESSAGES/quad.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/quad.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/quad.po b/docs/locales/ja/LC_MESSAGES/quad.po new file mode 100644 index 000000000..7d8438357 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/quad.po @@ -0,0 +1,353 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../quad.rst:7 a92e4967c80442ffb8a5751e8c321892 +msgid "Quad" +msgstr "" + +#: ../../quad.rst:9 7d461ee0397c4dcf8df7c27f3f318ef6 +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.rst:11 30896ef3614d4dd2aa6726d3059fda36 +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.rst:15 857546a0097d43c0a1d47132c9730e7e +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 "" + +#: ../../quad.rst:17 0f22de955ac04b30af935f0a00256655 +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 7ffa428d08e348a9979e7c6b34834010 +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 "" + +#: ../../quad.rst:23 a3acdc0e345b4a7cb8b0854a2c4b36d9 +msgid "**Methods / Attributes**" +msgstr "" + +#: ../../quad.rst:23 570fb4a7065341beb6a50417a0e8a47e +msgid "**Short Description**" +msgstr "" + +#: ../../quad.rst:25 d3ec3fa30238497e9ce8b023df98b913 +msgid ":meth:`Quad.transform`" +msgstr "" + +#: ../../quad.rst:25 09670f33e8ee401c98fa7cc445aa2300 +msgid "transform with a matrix" +msgstr "" + +#: ../../quad.rst:26 171c30e882a2445aade6512016c0c236 +msgid ":meth:`Quad.morph`" +msgstr "" + +#: ../../quad.rst:26 e254faa3875e4193a97fc36f3c5feab7 +msgid "transform with a point and matrix" +msgstr "" + +#: ../../quad.rst:27 ed0d06c9c518491bba8b26bd5663ecc2 +msgid ":attr:`Quad.ul`" +msgstr "" + +#: ../../quad.rst:27 caea6f5e9b5345099e08dc5e3bf056f3 +msgid "upper left point" +msgstr "" + +#: ../../quad.rst:28 06c8b5c8588e475da69671b91079e2f2 +msgid ":attr:`Quad.ur`" +msgstr "" + +#: ../../quad.rst:28 5dd1f8be2707446588a0a02bfb5a99af +msgid "upper right point" +msgstr "" + +#: ../../quad.rst:29 4ebe20162fab435e963c6fd096004cf4 +msgid ":attr:`Quad.ll`" +msgstr "" + +#: ../../quad.rst:29 948df607a961486ab4cc74a43837923f +msgid "lower left point" +msgstr "" + +#: ../../quad.rst:30 7a8da60fef2a40fdad792e35d37b687b +msgid ":attr:`Quad.lr`" +msgstr "" + +#: ../../quad.rst:30 cd28646c3d3a4269bbf63ad8782db4ff +msgid "lower right point" +msgstr "" + +#: ../../quad.rst:31 48a376ce50c7491fb46a11ae454db304 +msgid ":attr:`Quad.is_convex`" +msgstr "" + +#: ../../quad.rst:31 347356615bcc4f59a2084c5f68e6977a +msgid "true if quad is a convex set" +msgstr "" + +#: ../../quad.rst:32 3ce2d324f2974a6c99228b9be2bc1bbe +msgid ":attr:`Quad.is_empty`" +msgstr "" + +#: ../../quad.rst:32 95bf2c743244493a90efcaed0c3ff500 +msgid "true if quad is an empty set" +msgstr "" + +#: ../../quad.rst:33 0ce8856311c04e9997cbe4f001d83f12 +msgid ":attr:`Quad.is_rectangular`" +msgstr "" + +#: ../../quad.rst:33 aa774361f8874f34bf7fdb3dcb210cf2 +msgid "true if quad is congruent to a rectangle" +msgstr "" + +#: ../../quad.rst:34 954473ed350944d8b3b34fb7da18a17e +msgid ":attr:`Quad.rect`" +msgstr "" + +#: ../../quad.rst:34 3529660938a140a6a58a0fd28ee760f7 +msgid "smallest containing :ref:`Rect`" +msgstr "" + +#: ../../quad.rst:35 4553cc6bb5994b7da54a347367d3ec2a +msgid ":attr:`Quad.width`" +msgstr "" + +#: ../../quad.rst:35 b13447127de24539be61afae37b5f932 +msgid "the longest width value" +msgstr "" + +#: ../../quad.rst:36 3fb6857ad6ee42789a22a2ea7a82fa20 +msgid ":attr:`Quad.height`" +msgstr "" + +#: ../../quad.rst:36 67544e9663da42358814939ee4547348 +msgid "the longest height value" +msgstr "" + +#: ../../quad.rst:39 655ac91254064d6b9adbcbb62cdcb4d3 +msgid "**Class API**" +msgstr "" + +#: ../../quad.rst:51 5b5b374ead2b4e6ebab003bf4070ce5c +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 "" + +#: ../../quad.rst:53 d19fd4a9c7c64234b4154c0b24bac2f7 +msgid "If \"quad\" is specified, the constructor creates a **new copy** of it." +msgstr "" + +#: ../../quad.rst:55 cadc14296ace4c60b2a21ecdf0b6f447 +msgid "" +"Without parameters, a quad consisting of 4 copies of *Point(0, 0)* is " +"created." +msgstr "" + +#: ../../quad.rst:60 bce5ae88ad694aecba02bcd7dd5b2655 +msgid "" +"Modify the quadrilateral by transforming each of its corners with a " +"matrix." +msgstr "" + +#: ../../quad.rst 3111ceb4f04d424e81d373aaef308f2e +#: a92a4921877844d291b40107258ebe02 +msgid "Parameters" +msgstr "" + +#: ../../quad.rst:62 ../../quad.rst:69 b149b03526704e46836d747c27bd7249 +#: f1486420136d47fc854405b80ac4a153 +msgid "the matrix." +msgstr "" + +#: ../../quad.rst:66 8fd48178fb81454a99361a1389f0ff1b +msgid "" +"*(New in version 1.17.0)* \"Morph\" the quad with a matrix-like using a " +"point-like as fixed point." +msgstr "" + +#: ../../quad.rst:68 06f8a1f207204bd9b73fa1051127bcd1 +msgid "the point." +msgstr "" + +#: ../../quad.rst 832a240715834279ba1078970bd3f05f +msgid "Returns" +msgstr "" + +#: ../../quad.rst:70 df35abb07c7f4c9da1abe50da7a76732 +msgid "a new quad (no operation if this is the infinite quad)." +msgstr "" + +#: ../../quad.rst:75 e024af8ffee549e6bcc5226aa8258723 +msgid "" +"The smallest rectangle containing the quad, represented by the blue area " +"in the following picture." +msgstr "" + +#: ../../quad.rst 01d2e96377154ac0a4767d24085560a4 +#: 0795858f6a66414f9a048c13f68a474a 27fb0aadacaf417eaf08234085f7da11 +#: 351f779cf6a54e90a76d071ea3241701 441896790bf843ac84fe761564c0b2e7 +#: 45c61edac4204a278ece5c80b2181493 5c8aab0d86de48a0a04e1d4538737200 +#: 751056f433f3456495ad6e0a9754c346 e995a13e5d2f431aab7d128c8c619018 +#: f5d949e544fe4234bca6b072fd14a553 +msgid "type" +msgstr "" + +#: ../../quad.rst:79 a267b4703988411b8908511735467111 +msgid ":ref:`Rect`" +msgstr "" + +#: ../../quad.rst:83 3fc476292c8e45bdb479a96058085cbf +msgid "Upper left point." +msgstr "" + +#: ../../quad.rst:85 ../../quad.rst:91 ../../quad.rst:97 ../../quad.rst:103 +#: 10421b881d3744d6bedb1f8c6dfa6a72 289bb2be9627497498242e2265ce4870 +#: 605a00e16ef34c97a0802b6c86714b6c ff695cab04354fcca3292ed389a1832d +msgid ":ref:`Point`" +msgstr "" + +#: ../../quad.rst:89 2994a326d1c844b4b8686bbecac34814 +msgid "Upper right point." +msgstr "" + +#: ../../quad.rst:95 f567b3d5f4fc49ce98aa08919f50ff9f +msgid "Lower left point." +msgstr "" + +#: ../../quad.rst:101 a865e158445640cc874757d744ca19bf +msgid "Lower right point." +msgstr "" + +#: ../../quad.rst:107 d03a5c74b08247368ff41ab6ddface98 +msgid "New in version 1.16.1" +msgstr "" + +#: ../../quad.rst:109 c9198c3c88ce47cf9ffd53372777f147 +msgid "" +"Checks if for any two points of the quad, all points on their connecting " +"line also belong to the quad." +msgstr "" + +#: ../../quad.rst:114 ../../quad.rst:120 ../../quad.rst:126 +#: 0a745de4d6a14fc0837ff996e727c9dc c89cad895f1f4bc081582c19fa10952c +#: cae7fd6baaca4bf5aa2eb3529c68a847 +msgid "bool" +msgstr "" + +#: ../../quad.rst:118 3de34ba334fa450a825d711a8a011d29 +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 "" + +#: ../../quad.rst:124 4869564b46574eecbf070c322ac84f22 +msgid "" +"True if all corner angles are 90 degrees. This implies that the quad is " +"**convex and not empty**." +msgstr "" + +#: ../../quad.rst:130 4aea35830a30475b8ac9ff9fb52a5810 +msgid "The maximum length of the top and the bottom side." +msgstr "" + +#: ../../quad.rst:132 ../../quad.rst:138 946a3b32cc364cd4ac6b58750cbe73f2 +#: f3f7c71139bb4e3bb2fe0c86a10971df +msgid "float" +msgstr "" + +#: ../../quad.rst:136 36d814ff17c1418e9d3448df59b58e03 +msgid "The maximum length of the left and the right side." +msgstr "" + +#: ../../quad.rst:141 7d5190b5456c4ff0a0af1c6016e4c798 +msgid "Remark" +msgstr "" + +#: ../../quad.rst:142 f4ba1c436783496d8d477f39e1034311 +msgid "" +"This class adheres to the sequence protocol, so components can be dealt " +"with via their indices, too. Also refer to :ref:`SequenceTypes`." +msgstr "" + +#: ../../quad.rst:145 d2a57a03a00a43a2a4a8275440ed6f89 +msgid "Algebra and Containment Checks" +msgstr "" + +#: ../../quad.rst:146 4ba7ca7e8b4644968c321282fe318b5f +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 "" + +#: ../../quad.rst:148 bffb5df3b5a5437291618d6e720d69a7 +msgid "`{Point | IRect | Rect | Quad} in {IRect | Rect | Quad}`" +msgstr "" + +#: ../../quad.rst:150 7163e4ce212343049f257ac6f6d3d978 +msgid "Please note the following interesting detail:" +msgstr "" + +#: ../../quad.rst:152 9a381a63cc714b41a360dbe5b3b8b4ea +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 "" + +#: ../../footer.rst:-1 56a70a21860546d4b708ca68c00bc5d0 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/recipes-annotations.mo b/docs/locales/ja/LC_MESSAGES/recipes-annotations.mo new file mode 100644 index 000000000..e9b942e5d Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/recipes-annotations.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/recipes-annotations.po b/docs/locales/ja/LC_MESSAGES/recipes-annotations.po new file mode 100644 index 000000000..e1692b610 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/recipes-annotations.po @@ -0,0 +1,111 @@ +# 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" + +#: ../../recipes-annotations.rst:7 fca9c4e6a4f74af9bc327c4187c17074 +msgid "Annotations" +msgstr "注釈" + +#: ../../recipes-annotations.rst:12 7dd9e0f16f9a4eac8f33e49f313f412b +msgid "How to Add and Modify Annotations" +msgstr "注釈の追加と変更方法" + +#: ../../recipes-annotations.rst:14 422c8ba5314c4ea29d32a6c08b31a428 +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 5b98e8008c944301ac9375e5b40b2bc5 +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:18 b80efe25ff1d417d808d4360665a2d0d +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:24 b1ea65f64cd145cdbdcee83edcf8ef47 +msgid "This script should lead to the following output:" +msgstr "このスクリプトは次のような出力を生成します：" + +#: ../../recipes-annotations.rst:34 6d29fab88b624c38b18932e064259d09 +msgid "How to Use FreeText" +msgstr "FreeTextの使用方法" + +#: ../../recipes-annotations.rst:35 b082187fc3974bcbac0328898b9f144c +msgid "This script shows a couple of ways to deal with 'FreeText' annotations::" +msgstr "このスクリプトは、'FreeText'注釈を扱ういくつかの方法を示しています::" + +#: ../../recipes-annotations.rst:68 e61801b0888b426fb4076c53381b3c82 +msgid "The result looks like this:" +msgstr "結果は次のようになります。" + +#: ../../recipes-annotations.rst:79 a48dd471be5c46f5ad426e8b92c89049 +msgid "Using Buttons and JavaScript" +msgstr "ボタンとJavaScriptの使用" + +#: ../../recipes-annotations.rst:80 2ac36aa3635b42fabc2f108aea3e539d +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フォントの太字や斜体バージョンをサポートしていません。" + +#: ../../recipes-annotations.rst:82 774300ad8c5a442fae28358fd27a7451 +msgid "" +"A big **thank you** to our user `@kurokawaikki " +"`_, who contributed the following script" +" to **circumvent this restriction**." +msgstr "この制限を回避するために、次のスクリプトを提供してくれたユーザー `@kurokawaikki `_ さんに心から感謝します。" + +#: ../../recipes-annotations.rst:93 ddd0e3e4c05949c0a6d2f621ec5b5dfd +msgid "How to Use Ink Annotations" +msgstr "インク注釈の使用方法" + +#: ../../recipes-annotations.rst:94 24be590b851c4c1fb2256c0c274964db +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:96 a55c500826a04a3bb9ceeb0dfe572617 +msgid "" +"The following script creates an ink annotation with two mathematical " +"curves (sine and cosine function graphs) as line segments::" +msgstr "以下のスクリプトは、二つの数学的な曲線（正弦関数と余弦関数のグラフ）を線セグメントとして持つインク注釈を作成します::" + +#: ../../recipes-annotations.rst:141 b2edda413cd54962b844b16dee60b2db +msgid "This is the result:" +msgstr "これが結果です：" + +#: ../../footer.rst:-1 decad967a0724912a6afd25ceca5ca19 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/recipes-common-issues-and-their-solutions.mo b/docs/locales/ja/LC_MESSAGES/recipes-common-issues-and-their-solutions.mo new file mode 100644 index 000000000..4851dc186 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/recipes-common-issues-and-their-solutions.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/recipes-common-issues-and-their-solutions.po b/docs/locales/ja/LC_MESSAGES/recipes-common-issues-and-their-solutions.po new file mode 100644 index 000000000..43b26b367 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/recipes-common-issues-and-their-solutions.po @@ -0,0 +1,546 @@ +# 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" + +#: ../../recipes-common-issues-and-their-solutions.rst:7 +#: fa2f57e0b01e4bd2bd610b36b0d51451 +msgid "Common Issues and their Solutions" +msgstr "一般的な問題とその解決方法" + +#: ../../recipes-common-issues-and-their-solutions.rst:10 +#: ec61ccdb6e7f47beaaa2004b4030b24b +msgid "How To Dynamically Clean Up Corrupt :title:`PDFs`" +msgstr "壊れた :title:`PDF` を動的にクリーンアップする方法" + +#: ../../recipes-common-issues-and-their-solutions.rst:12 +#: 8d83786622004100aa23691ec76b2cd9 +msgid "" +"This shows a potential use of :title:`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 +#: 24a4958fb00d450182436bdc4995b2d9 +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 +#: c4226346c1e742aaa8538ad7268ade47 +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 +#: 5675d1d6a81348fc81536da9c24584d9 +msgid "How to Convert Any Document to :title:`PDF`" +msgstr "どの文書も :title:`PDF` に変換する方法" + +#: ../../recipes-common-issues-and-their-solutions.rst:57 +#: 0399986aaae4409e839b8ec74f9b2fc5 +msgid "" +"Here is a script that converts any :title:`PyMuPDF` :ref:`supported " +"document` to a :title:`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 +#: b1c2e0f757a44b4dbd7b8654e63c1c6b +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 +#: 77608936a65c467dbe14e13c7deea8b0 +msgid "How to Deal with Messages Issued by :title:`MuPDF`" +msgstr ":title:`MuPDF` から発行されるメッセージの処理方法" + +#: ../../recipes-common-issues-and-their-solutions.rst:133 +#: a4d2cbb5656a48aa89ea973a7177925f +msgid "" +"Since :title:`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* にリダイレクトされます。したがって、これらのメッセージはこのデバイスに出力される他の出力と同様に扱うことができます。" + +#: ../../recipes-common-issues-and-their-solutions.rst:135 +#: 69525f9f9beb4c1d9b93567d2f9092f7 +msgid "" +"In addition, these messages go to the internal buffer together with any " +":title:`MuPDF` warnings -- see below." +msgstr "さらに、これらのメッセージはMuPDFの警告とともに内部バッファに送られます - 以下を参照してください。" + +#: ../../recipes-common-issues-and-their-solutions.rst:137 +#: d54b35c038b94c09868ac9212f889da7 +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 `fitz.TOOLS.mupdf_display_errors(False)`." +msgstr "これらのメッセージは常に識別用の文字列 `"mupdf:"` で始まります。復旧可能なMuPDFエラーを全く表示したくない場合は、コマンド `fitz.TOOLS.mupdf_display_errors(False)` を発行してください。" + +#: ../../recipes-common-issues-and-their-solutions.rst:140 +#: 09c057f557724c7290f5c2d912a9d475 +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` を使用して表示できます。" + +#: ../../recipes-common-issues-and-their-solutions.rst:142 +#: 2e59d0ec4544438dbd9dcdeae85410c2 +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が回復して処理を続けることができるエラーメッセージが表示される可能性があります。" + +#: ../../recipes-common-issues-and-their-solutions.rst:144 +#: ae2cc84b5f874158a39c9cd0d86ed926 +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 `fitz.open` the " +"document had to be repaired:" +msgstr "回復可能なエラーの例出力です。損傷したPDFを開いていますが、MuPDFはそれを修復し、何が起こったかに関する少しの情報を提供しています。その後、ドキュメントが後で増分保存できるかどうかを調べる方法も示しています。この時点で :attr:`Document.is_dirty` 属性をチェックすることも、 `fitz.open` の際にドキュメントを修復する必要があったことを示しています::" + +#: ../../recipes-common-issues-and-their-solutions.rst:165 +#: 2ee25728a8b2458f8376a3eff068b6c9 +msgid "Example output for an **unrecoverable error**:" +msgstr "**復旧できないエラー**の例出力:" + +#: ../../recipes-common-issues-and-their-solutions.rst:181 +#: 80f2fbfa5d7a49e5a40e57abcc3727ee +msgid "Changing Annotations: Unexpected Behaviour" +msgstr "注釈の変更：予期しない動作" + +#: ../../recipes-common-issues-and-their-solutions.rst:184 +#: ../../recipes-common-issues-and-their-solutions.rst:226 +#: 515f3096a12b4b78a641512e8f7d471b b725441fb61943a1aed6647defa00a68 +msgid "Problem" +msgstr "問題" + +#: ../../recipes-common-issues-and-their-solutions.rst:185 +#: c4f7241bade6442e9fe03cd89070126b +msgid "There are two scenarios:" +msgstr "2つのシナリオがあります：" + +#: ../../recipes-common-issues-and-their-solutions.rst:187 +#: cfdd21913fb74c0586ee2ffbf0b8ff2e +msgid "" +"**Updating** an annotation with PyMuPDF which was created by some other " +"software." +msgstr "他のソフトウェアで作成された注釈をPyMuPDFで**更新**する。" + +#: ../../recipes-common-issues-and-their-solutions.rst:188 +#: a407f9a3a1114dfe89db8ac329504ec8 +msgid "" +"**Creating** an annotation with PyMuPDF and later changing it with some " +"other software." +msgstr "PyMuPDFで注釈を**作成**し、後で他のソフトウェアで変更する。" + +#: ../../recipes-common-issues-and-their-solutions.rst:190 +#: 1747eccafc174b6ead2f6d485c245257 +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:193 +#: ../../recipes-common-issues-and-their-solutions.rst:231 +#: ../../recipes-common-issues-and-their-solutions.rst:301 +#: ../../recipes-common-issues-and-their-solutions.rst:314 +#: 08c416188d1b4b91b73cde0ef6accde1 66771ce99d9b400c8051457950d641e6 +#: a144736dab7b4fdcb2d59370f4790a23 a1a027bb5cf848219170299541afb0cc +msgid "Cause" +msgstr "原因" + +#: ../../recipes-common-issues-and-their-solutions.rst:194 +#: 11e4d8b1d16c4de89e393a67f1621845 +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:196 +#: c58452e6b0e94e9883f4daf7ee440817 +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:198 +#: 66c8e970f38d40b8b3843ef6e0cad890 +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:200 +#: 52bb936a5e274dcba3f3d28f8ae3e76a +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:202 +#: 005d3593fa2045e8a0c4aa5539be5148 +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:204 +#: 06521f085471483ca6b68632f830e513 +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:208 +#: ../../recipes-common-issues-and-their-solutions.rst:267 +#: 5f20baadc2e84e518d57ef73c015d785 a1fd829f9d184c36acf3ff227a8a33a0 +msgid "Solutions" +msgstr "解決策" + +#: ../../recipes-common-issues-and-their-solutions.rst:209 +#: 8115559b363f43cb8007689ede1a5c9d +msgid "Unfortunately there is not much you can do in most of these cases." +msgstr "残念ながら、これらの多くの場合、あまり対処できることはありません。" + +#: ../../recipes-common-issues-and-their-solutions.rst:211 +#: 4398a3b74cb54c93aa92e7b886b2f91c +msgid "Stay with the same software for **creating and changing** an annotation." +msgstr "注釈の作成と変更に同じソフトウェアを使用してください。" + +#: ../../recipes-common-issues-and-their-solutions.rst:212 +#: cbf85698214b4043bca7b5fcce2345bf +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:214 +#: 06df75d0a4d44e61883293f84788da21 +msgid ":meth:`Annot.set_rect` (location changes)" +msgstr ":meth:`Annot.set_rect` (位置の変更)" + +#: ../../recipes-common-issues-and-their-solutions.rst:215 +#: 76064550befd48d3b5396fd63806747c +msgid ":meth:`Annot.set_flags` (annotation behaviour)" +msgstr ":meth:`Annot.set_flags` (注釈の動作)" + +#: ../../recipes-common-issues-and-their-solutions.rst:216 +#: f4223abd7dbb4bb1898cdf66ed49b53f +msgid ":meth:`Annot.set_info` (meta information, except changes to *content*)" +msgstr ":meth:`Annot.set_info` (メタ情報、*コンテンツ* の変更以外)" + +#: ../../recipes-common-issues-and-their-solutions.rst:217 +#: d2517fe8342d4955a077ec828f55c003 +msgid ":meth:`Annot.set_popup` (create popup or change its rect)" +msgstr ":meth:`Annot.set_popup` (ポップアップの作成または位置の変更)" + +#: ../../recipes-common-issues-and-their-solutions.rst:218 +#: 968a51602c3c4987ad5b4466d419ebce +msgid "" +":meth:`Annot.set_optional_content` (add / remove reference to optional " +"content information)" +msgstr ":meth:`Annot.set_optional_content` (オプションコンテンツ情報への参照の追加/削除)" + +#: ../../recipes-common-issues-and-their-solutions.rst:219 +#: f173494b91df42f392a48b9543553809 +msgid ":meth:`Annot.set_open`" +msgstr "" + +#: ../../recipes-common-issues-and-their-solutions.rst:220 +#: f8d9a1af44e14abb93bfd993d0a159df +msgid ":meth:`Annot.update_file` (file attachment changes)" +msgstr ":meth:`Annot.update_file` (ファイル添付の変更)" + +#: ../../recipes-common-issues-and-their-solutions.rst:223 +#: 7a98e28b5179491595e547f1c97e7710 +msgid "Misplaced Item Insertions on PDF Pages" +msgstr "PDFページ上の誤ったアイテムの挿入" + +#: ../../recipes-common-issues-and-their-solutions.rst:228 +#: 5e47ddbf5c1c4ed28e1cb97bb2b7915e +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ページにアイテム（画像、注釈、テキストなど）を挿入しましたが、後で意図した場所とは異なる位置に配置されていることがあります。たとえば、画像はページの上部に挿入する予定でしたが、予想外にページの下部近くに表示されています。" + +#: ../../recipes-common-issues-and-their-solutions.rst:233 +#: 15530cb28def4c2f943f7e6fe5557b32 +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）が左下にある点から、左上の点に変更されています。したがって、上下が逆転し、挿入が誤って配置されてしまいます。" + +#: ../../recipes-common-issues-and-their-solutions.rst:235 +#: f99d9be8fb484cf0a92461986d1094d8 +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ではバイト）として格納されます。" + +#: ../../recipes-common-issues-and-their-solutions.rst:237 +#: 34ec54790d334564b5cbe68c8a94fd47 +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（「グラフィックスステートの復元」または「アンスタック」）で囲む必要があります。" + +#: ../../recipes-common-issues-and-their-solutions.rst:241 +#: 08e57cbd2265452d85ee7fa875e35932 +msgid "So the PDF creator did this::" +msgstr "したがって、PDFの作成者は次のように行いました::" + +#: ../../recipes-common-issues-and-their-solutions.rst:249 +#: cb2f8721c8c64ee6bb95271353b44c0f +msgid "where they should have done this::" +msgstr "正しくは、次のように行うべきでした::" + +#: ../../recipes-common-issues-and-their-solutions.rst:260 +#: 7c49613e6c4c4448bf97bf2b874557b1 +msgid "" +"In the mini-language's syntax, spaces and line breaks are equally " +"accepted token delimiters." +msgstr "ミニ言語の構文では、スペースと改行は同様にトークンの区切りとして受け入れられます。" + +#: ../../recipes-common-issues-and-their-solutions.rst:261 +#: 5d38d66927e444c08022b6549b1df157 +msgid "Multiple consecutive delimiters are treated as one." +msgstr "複数の連続した区切りは、1つとして扱われます。" + +#: ../../recipes-common-issues-and-their-solutions.rst:262 +#: 9e3101a477bc4b14bc5c7a03e9aebedf +msgid "" +"Keywords \"stream\" and \"endstream\" are inserted automatically -- not " +"by the programmer." +msgstr "キーワード「stream」と「endstream」は自動的に挿入されます - プログラマーによって挿入されるものではありません。" + +#: ../../recipes-common-issues-and-their-solutions.rst:269 +#: 5762387a2295416bb2076303149b60c3 +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があり、ページの内容がその文字列ペアでラップされているかどうかを確認できます。" + +#: ../../recipes-common-issues-and-their-solutions.rst:271 +#: ff556712b3b340688943465c16ee859f +msgid "" +"If it is *False* or if you want to be on the safe side, pick one of the " +"following:" +msgstr "それが `False` であるか、安全側に立ちたい場合、次のいずれかを選択してください：" + +#: ../../recipes-common-issues-and-their-solutions.rst:273 +#: ef5fa95c952141c8b772b2f4ff87abb5 +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` を実行します。" + +#: ../../recipes-common-issues-and-their-solutions.rst:274 +#: d3970df080c241c88a07650020bedd87 +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 …` で前処理し、その出力ファイルで作業します。" + +#: ../../recipes-common-issues-and-their-solutions.rst:275 +#: 4a3857e5939847c98355c84888136735 +msgid "" +"Directly wrap the page's :data:`contents` with the stacking commands " +"before you do your first item insertion." +msgstr "最初のアイテム挿入を行う前に、直接ページの内容をスタッキングコマンドでラップします。" + +#: ../../recipes-common-issues-and-their-solutions.rst:277 +#: 5e1455b47ecc4e20ab033d003caa9a31 +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つに結合されるなど、さまざまな操作が行われます。" + +#: ../../recipes-common-issues-and-their-solutions.rst:279 +#: 8cb5922772e74867bc4bb0922b2d60af +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` を指定して新しいファイルに保存することを検討する必要があります。" + +#: ../../recipes-common-issues-and-their-solutions.rst:281 +#: b7478c7cd10548599181db60ff509ed2 +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` でラップします。" + +#: ../../recipes-common-issues-and-their-solutions.rst:283 +#: 7f832720e4c54e3b979afa37f6dcb90f +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がデジタル署名されており、このステータスを変更できない場合に便利です。" + +#: ../../recipes-common-issues-and-their-solutions.rst:285 +#: 2c040a0cf1804b6982ebd5f88b476db9 +msgid "We recommend the following snippet to get the situation under control:" +msgstr "次のスニペットを使用して状況をコントロールすることをお勧めします：" + +#: ../../recipes-common-issues-and-their-solutions.rst:293 +#: 9c659a84ac5c426b8f0a1f6bd64b90e4 +msgid "Missing or Unreadable Extracted Text" +msgstr "欠落または読み取り不可能な抽出テキスト" + +#: ../../recipes-common-issues-and-their-solutions.rst:294 +#: 349031568f244add9b1ee51222247acf +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:297 +#: 2773e5d298e04e91871caae3718732ed +msgid "Problem: no text is extracted" +msgstr "問題：テキストが抽出されない" + +#: ../../recipes-common-issues-and-their-solutions.rst:298 +#: db5eea7716d94201a8cc74d0cc90eba3 +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:302 +#: 6701a64fb6b3427b994b3eb9785ab23b +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:303 +#: 211a0de02fdf4701a7ad88d00869ab8c +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:306 +#: ../../recipes-common-issues-and-their-solutions.rst:319 +#: 8595726e84a04e6c97bba8ab071ae4aa 996ccfa52b5d4ffdb932aab19594a763 +msgid "Solution" +msgstr "解決策" + +#: ../../recipes-common-issues-and-their-solutions.rst:307 +#: bfa52f92098642f59706455d42974d55 +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:310 +#: 84ac082b61f54a6682189954d5bbc601 +msgid "Problem: unreadable text" +msgstr "問題：読み取れないテキスト" + +#: ../../recipes-common-issues-and-their-solutions.rst:311 +#: 99ce0e2b97274fa48c1a28e132ea5655 +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:315 +#: 9734341f85d545b8ba8e9e84e770858a +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:316 +#: 1eef3f19b55041aeb68b6952ec16430c +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:320 +#: cd8ebe20912d4683a30d482eed357d14 +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:321 +#: 30b9c0641ff3480db4535887483556bf +msgid "" +"If other text extraction tools also don't work, then the only solution " +"again is OCRing the page." +msgstr "他のテキスト抽出ツールも機能しない場合は、再びOCRでページを処理するのが唯一の解決策です。" + +#: ../../footer.rst:-1 8bd2aa51e72a469797c95d3e65e4b8da +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/recipes-drawing-and-graphics.mo b/docs/locales/ja/LC_MESSAGES/recipes-drawing-and-graphics.mo new file mode 100644 index 000000000..f73c5dd31 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/recipes-drawing-and-graphics.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/recipes-drawing-and-graphics.po b/docs/locales/ja/LC_MESSAGES/recipes-drawing-and-graphics.po new file mode 100644 index 000000000..b2e961ee1 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/recipes-drawing-and-graphics.po @@ -0,0 +1,170 @@ +# 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" + + +#: ../../recipes-drawing-and-graphics.rst:7 3dca2193540743c48ca696994d1b2bf4 +msgid "Drawing and Graphics" +msgstr "描画とグラフィックス" + +#: ../../recipes-drawing-and-graphics.rst:10 d48c48541a60449bbe91bc53e6cb9711 +msgid "" +"PDF files support elementary drawing operations as part of their syntax. " +"This includes basic geometrical objects like lines, curves, circles, " +"rectangles including specifying colors." +msgstr "PDFファイルは、その構文の一部として基本的な描画操作をサポートしています。これには、線、曲線、円、四角形などの基本的な幾何学的オブジェクトや色の指定が含まれます。" + +#: ../../recipes-drawing-and-graphics.rst:12 7abc2e1d35be4d4d9a0bed5f5d4795c1 +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:14 5fc7cd1b79b24528bb23e0d603e43b82 +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:16 bf872da04ef64b38a0d0e8aa534ae27a +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 = fitz.Rect(...)*." +msgstr "シェイプは常にページの子として作成され、通常は `shape = page.new_shape()` のような命令で行います。このクラスは、ページの領域に描画操作を実行するための多数のメソッドを定義しています。たとえば、 `last_point = shape.draw_rect(rect)` は、適切に定義された `rect = fitz.Rect(…)` の境界に沿って四角形を描画します。" + +#: ../../recipes-drawing-and-graphics.rst:18 a36013055d34439180d813ef0bfc702b +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:20 e838b2dd4bd24844bf2c66494908568e +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:22 0421e6623b1b42d784e5683623971e7d +msgid "" +"If you import this script, you can also directly use its graphics as in " +"the following example::" +msgstr "このスクリプトをインポートすると、次の例のようにそのグラフィックスを直接使用することもできます::" + +#: ../../recipes-drawing-and-graphics.rst:80 d8e75588ded14a99822089924b350f78 +msgid "This is the script's outcome:" +msgstr "これがスクリプトの結果です:" + +#: ../../recipes-drawing-and-graphics.rst:88 f85f9129c62d495d804e8f8dd43b3d35 +msgid "How to Extract Drawings" +msgstr "描画の抽出方法" + +#: ../../recipes-drawing-and-graphics.rst:90 8f2c184a70774378b11fdf95b4296585 +msgid "New in v1.18.0" +msgstr "v1.18.0で新登場" + +#: ../../recipes-drawing-and-graphics.rst:92 eccd01c0e40641349c31320abd8516a0 +msgid "" +"The drawing commands issued by a page can be extracted. 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:94 e04b52d755d34ea6ab35054820f3d960 +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:96 7ceabc5059be4cc092b2d27d6c458d7b +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:131 544d6efc517b426aa6299e72c69f5069 +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:134 ea8f8b95360f46e181dcd8ef691fd8fc +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:185 0f1b2b08b2f741c5a4ea409dcfeeeebf +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:187 fb7ea95431d14f39b69a28adca742271 +msgid "" +"Here is a comparison between input and output of an example page, created" +" by the previous script:" +msgstr "以下は、前のスクリプトで作成された例のページの入力と出力の比較です。" + +#: ../../recipes-drawing-and-graphics.rst:192 124458f35bd44ac5867a6d96d00bea1b +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:194 1b4d4170da6b464da25516224cfdea6d +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:196 a2488d1c37bf40a49356239245f7776b +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 "パスのリストを使用して、ページ上のすべての線またはすべての四角形などのリストを作成し、色やページ上の位置などの基準でサブセレクトすることができます。" + +#: ../../footer.rst:-1 4bdf6ec769944d908d6f31f3594ce128 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/recipes-images.mo b/docs/locales/ja/LC_MESSAGES/recipes-images.mo new file mode 100644 index 000000000..61229f28b Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/recipes-images.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/recipes-images.po b/docs/locales/ja/LC_MESSAGES/recipes-images.po new file mode 100644 index 000000000..c7286e619 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/recipes-images.po @@ -0,0 +1,951 @@ +# 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" + +#: ../../recipes-images.rst:7 2d499873848b4ae39a30cab2edbdf6e0 +msgid "Images" +msgstr "画像" + +#: ../../recipes-images.rst:14 2469433a9ccf401f829c19887b5554d1 +msgid "How to Make Images from Document Pages" +msgstr "ドキュメントページから画像を作成する方法" + +#: ../../recipes-images.rst:16 5c24b22b451f4ff284f243cba6e42ffb +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 5cf119f727a245fc9e03c0ab12895b14 +msgid "The document can be any :ref:`supported type`." +msgstr "文書の種類は、:ref:`サポートされている ` どんな形式でも構いません。" + +#: ../../recipes-images.rst:20 5374b786b72d432a89040575cd959d30 +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 7f9a716c65c74cb8a61898a3ca75b7fd +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 2ead27ba30784960b6825fb86a751494 +msgid "How to Increase :index:`Image Resolution `" +msgstr "画像の解像度を上げる方法" + +#: ../../recipes-images.rst:39 0d4f6d4d81634b57984e01cb039c51e4 +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 d4edd84ef0774193a98ef54edcc0e988 +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 3435a9552746460eac9967e3821df142 +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 f578a9910dbf4988836bc1d875b7940c +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 7347a60fc39645a5aaf2ec71d1cd16bc +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 d3934eb54f8d4e20b2656aa663c94552 +msgid "How to Create :index:`Partial Pixmaps` (Clips)" +msgstr "部分的なPixmap（クリップ）の作成方法" + +#: ../../recipes-images.rst:62 be6c4b8ea90d4b18ae93ab850beb75cf +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 b72ae0259a69460ba708e4862ebfc301 +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 f986446d239d494a92cee0968ee853fa +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 d333f7437ff34af984f917249ae2c719 +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 0cd6de3302cc4bae8367342f8bf15089 +msgid "How to Zoom a Clip to a GUI Window" +msgstr "GUIウィンドウにクリップをズームする方法" + +#: ../../recipes-images.rst:88 29d0a3ead95344008e77da1c1dd89254 +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 5b4ed7bb09e943d69c05a6ef5f0da800 +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 2ad153c1582d4ab38d0b8be1b15dfd30 +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 69b0a38d38ee447aac22613bc7e95e6d +msgid "How to Create or Suppress Annotation Images" +msgstr "注釈画像の作成または抑制方法" + +#: ../../recipes-images.rst:125 93ca0fc063e44ddcbeb6b39ef3b667b3 +msgid "" +"Normally, the pixmap of a page also shows the page's annotations. " +"Occasionally, this may not be desirable." +msgstr "通常、ページのピクマップにはページの注釈も表示されます。しかし、時にはこれが望ましくない場合があります。" + +#: ../../recipes-images.rst:127 57fc231418dd40ed85c26f5b07d94d83 +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 4929c630bae340c49f480eeada414b91 +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 56352e975f38492ea9b6ba7c05a5c1fe +msgid "How to Extract Images: Non-PDF Documents" +msgstr "画像の抽出方法：非PDFドキュメント" + +#: ../../recipes-images.rst:143 c08bfbb5dbcd454bb29f48f93aae2e91 +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 61e9accd7c1d423f9ce4e6a4ff45f48f +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 06a2cf373b42475eacbfc7ba43a29d18 +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 82861f78ef3b491497c3399fdac53bf6 +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 a5e7c5437dc94ed9a21baa5aab888cea +msgid "How to Extract Images: PDF Documents" +msgstr "画像の抽出方法：PDFドキュメント" + +#: ../../recipes-images.rst:184 5ca6689377ef4d64b7968c3e0cdcb0f3 +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 e3e0d5e90efc482f9cf8a2f16fe8c6ba +msgid "" +"**Create** a :ref:`Pixmap` of the image with instruction *pix = " +"fitz.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 = fitz.Pixmap(doc, xref)` 。この方法は非常に高速です（単桁のマイクロ秒）。 :ref:`Pixmap` のプロパティ（幅、高さなど）は、画像のものと同じになります。この場合、埋め込まれたオリジナルの画像形式を判別する方法はありません。" + +#: ../../recipes-images.rst:188 0c937f981430483ab181dae6efbd41c1 +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 = " +"fitz.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 = fitz.Pixmap(doc, xref);pix.tobytes()` と比較する必要があります。埋め込まれた画像がPNG形式の場合、 :meth:`Document.extract_image` の速度はほぼ同じで（バイナリ画像データも同じです）、それ以外の場合は、このメソッドは数千倍高速であり、画像データも小さくなります。 +未だ疑問が残ります。" + +#: ../../recipes-images.rst:190 2ae14695324044789c62cf34eaf8933a +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 d454ec2440dd445886a5488e9b9e784c +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 42a46f89556e4867877696fcb6a9b964 +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 e0ace1f79e99438387b1d66c3b8a23ad +msgid "" +"For both extraction approaches, there exist ready-to-use general purpose " +"scripts:" +msgstr "これらの抽出方法の両方に対して、一般的な用途のスクリプトが存在します。" + +#: ../../recipes-images.rst:197 0f73b7441e034e4ea943578b003588d7 +msgid "" +"`extract-from-pages.py `_ " +"extracts images page by page:" +msgstr "`extract-from-pages.py `_ はページごとに画像を抽出します。" + +#: ../../recipes-images.rst:202 bdc91d1171a44305b1cfd558e052deef +msgid "" +"and `extract-from-xref.py `_ " +"extracts images by xref table:" +msgstr "`extract-from-xref.py `_ はxrefテーブルによって画像を抽出します。" + +#: ../../recipes-images.rst:213 8c6c9dea5a344483826be985cd46513d +msgid "How to Handle Image Masks" +msgstr "画像マスクの処理方法" + +#: ../../recipes-images.rst:214 3055bd4dc13b49bdaac30a186f506030 +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 b6119567b16e4102993ca0c3181df4f0 +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 548d079c8de9467db2a4dd68da4587f9 +msgid "" +"An item of :meth:`Document.get_page_images` has the general format " +"`(xref, smask, ...)`, where *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 77f1e1591ed7455d8eca58857b667e75 +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 55abe20020cb4397a32ae1bae58f6b34 +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 9fcf24f31c844eccbf48f33dc41adc02 +msgid "" +"To recover the original image using PyMuPDF, the procedure depicted as " +"follows must be executed:" +msgstr "PyMuPDFを使用して元の画像を復元するためには、以下に示す手順を実行する必要があります：" + +#: ../../recipes-images.rst:232 3d4ad6a20b784433bb4b164aeab95d68 +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 9ee909a9cd76403fa6e23e583dc37a91 +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 12d21f1a64934a07b6166a50a5087733 +msgid "How to Make one PDF of all your Pictures (or Files)" +msgstr "すべての写真（またはファイル）を1つのPDFにする方法" + +#: ../../recipes-images.rst:251 5b3266aaed7a4a66abbd7c10d70ec406 +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 5f1b7ab6f25f459e855a5082b08fdb95 +msgid "**Method 1: Inserting Images as Pages**" +msgstr "**方法1：画像をページとして挿入する方法**" + +#: ../../recipes-images.rst:255 543f578a52b84d15820b43f3319bb28a +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 92057893ccfb4ab29d09a829f3725cd3 +msgid "" +"This will generate a PDF only marginally larger than the combined " +"pictures' size. Some numbers on performance:" +msgstr "これにより、結合された画像のサイズとほとんど変わらないPDFが生成されます。パフォーマンスに関するいくつかの数値：" + +#: ../../recipes-images.rst:280 61aa34732e5c4518ac97edc58fab1553 +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 f648cd28ee22447d9737d895193de6b0 +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 e902e231be14403da5c702874c628980 +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 bb1b5148168841238264bb5dda28c1f9 +msgid "**Method 2: Embedding Files**" +msgstr "**方法2：ファイルの埋め込み**" + +#: ../../recipes-images.rst:291 08db93cf9e9b4fa58577b143ed5dd428 +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 e0e27d1c3a624161b8f9848a635a8b38 +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 ab967f2002c0457db078a20e61d1e983 +msgid "**Method 3: Attaching Files**" +msgstr "**方法3：ファイルの添付**" + +#: ../../recipes-images.rst:320 ab4c48a2f12e4f7a84373b5b72bb1bf2 +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 4645b87dfb3e4d77a840fbde66c33f9d +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 f0957197d5a84348b8b93628757aedd8 +msgid "" +"Both, the **embed** and the **attach** methods can be used for " +"**arbitrary files** -- not just images." +msgstr "埋め込みと添付の両方の方法は、画像だけでなく任意のファイルにも使用できます。" + +#: ../../recipes-images.rst:328 acc340d03ce54fceb8026db0b8688a43 +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 7de63704118d42fa9888a8480376eb95 +msgid "How to Create Vector Images" +msgstr "ベクター画像の作成方法" + +#: ../../recipes-images.rst:343 6f0759547e1a4e0ebb00c7baabbcb83f +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 78c6a7d57f834a098e31fed5b90bc901 +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 ec1b0c73ada74a83a4027e01f5dba15a +msgid "" +"Instruction *svg = page.get_svg_image(matrix=fitz.Identity)* delivers a " +"UTF-8 string *svg* which can be stored with extension \".svg\"." +msgstr "指示 `svg = page.get_svg_image(matrix=fitz.Identity)` はUTF-8文字列 *svg* を提供します。これは \".svg\" の拡張子で保存できます。" + +#: ../../recipes-images.rst:363 6033c00ed4cc4912ab6ea79ae6fec28a +msgid "How to Convert Images" +msgstr "画像の変換方法" + +#: ../../recipes-images.rst:364 a6b2a60a27c347f5a4c5968196dad5b2 +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 ee3e163fa97d48e7bad096db61afd241 +msgid "Notwithstanding that interfacing with Pillow is almost trivial." +msgstr "ただし、Pillowとの連携はほとんど自明です。" + +#: ../../recipes-images.rst:369 fb634df5b6fc4121a820feec7b14d045 +msgid "**Input Formats**" +msgstr "**入力フォーマット**" + +#: ../../recipes-images.rst:369 d00fc113ff7046b3b415111854c64046 +msgid "**Output Formats**" +msgstr "**出力フォーマット**" + +#: ../../recipes-images.rst:369 bf1a51e4573941548b940bf530db0b61 +msgid "**Description**" +msgstr "**説明**" + +#: ../../recipes-images.rst:371 93f0f9dfea454e01b1cc8de94c78e477 +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 24cf358e0c8a4439b461ac2c8523285e +#: 7b0e8a8b583041a597f3ade31a6f694e 851bdac2c61643bb99fa12476afb2e1d +#: 860175be490c4c51b698f359b01b1bff 8d2e64c6a6f341e29f8859589a1994ec +#: e4b7b3b48d2b403ebf6b240a41c8f452 ffc99ba1e7614558add92ff4f6099cea +msgid "." +msgstr "" + +#: ../../recipes-images.rst:371 5701cc42969e4563884938b6fa3b2309 +msgid "Windows Bitmap" +msgstr "" + +#: ../../recipes-images.rst:372 51bce2eeb5b349d39717412303d0c9f7 +#: 885b7c94e90547a3baafd82502861631 +msgid "JPEG" +msgstr "" + +#: ../../recipes-images.rst:372 5126f29e49de4a8fb610a3d5c1e1a0d4 +msgid "Joint Photographic Experts Group" +msgstr "" + +#: ../../recipes-images.rst:373 67ced6678d3d49e5891472010fa8c9d9 +msgid "JXR" +msgstr "" + +#: ../../recipes-images.rst:373 ffed87521bd44ffcb940b31610e85060 +msgid "JPEG Extended Range" +msgstr "" + +#: ../../recipes-images.rst:374 49b170aaba804465b9782348875d4e00 +msgid "JPX/JP2" +msgstr "" + +#: ../../recipes-images.rst:374 fbdad68b6fe74f26b3cca9f31ad253cd +msgid "JPEG 2000" +msgstr "" + +#: ../../recipes-images.rst:375 bd84b326237c4b3881ab372c102c244e +msgid "GIF" +msgstr "" + +#: ../../recipes-images.rst:375 67227c2e068342e4aee7f12af8c62555 +msgid "Graphics Interchange Format" +msgstr "" + +#: ../../recipes-images.rst:376 493c76c3e5c540898eace4cac6531dfc +msgid "TIFF" +msgstr "" + +#: ../../recipes-images.rst:376 3ed7a016aeba463fa703d018e2b5ac2f +msgid "Tagged Image File Format" +msgstr "" + +#: ../../recipes-images.rst:377 9539692212974c439a1c0fc05bcb614c +#: dcf4409883804e62980ed617e2049adf +msgid "PNG" +msgstr "" + +#: ../../recipes-images.rst:377 3f12da8032e84fd9aba8f8b43092b6ac +msgid "Portable Network Graphics" +msgstr "" + +#: ../../recipes-images.rst:378 d834f2268ac748779d318f5087315e3e +#: ebacfe7bc6394c0ea80b7c864a2f8b45 +msgid "PNM" +msgstr "" + +#: ../../recipes-images.rst:378 fe29e5da816f43639532b37f78fd95f7 +msgid "Portable Anymap" +msgstr "" + +#: ../../recipes-images.rst:379 a2159e56a7bc49d996db7124561bbc78 +#: c31f1b8f09a740cf86962f2b3a4e2b8a +msgid "PGM" +msgstr "" + +#: ../../recipes-images.rst:379 0950a3c8a8c04814bddd36706506f2cd +msgid "Portable Graymap" +msgstr "" + +#: ../../recipes-images.rst:380 40194dee132b4e3aad4ed5986de48129 +#: fd3f039f4fc14f22bd3416f29486ea9d +msgid "PBM" +msgstr "" + +#: ../../recipes-images.rst:380 159e74cce70f42aca0d9631a5807289c +msgid "Portable Bitmap" +msgstr "" + +#: ../../recipes-images.rst:381 1a22cebded6c445a9b08fe0b48458de8 +#: 1c5e2057775748228d990220a47d8de3 +msgid "PPM" +msgstr "" + +#: ../../recipes-images.rst:381 c26aeb2083b14efb93372dfc5fb49bf0 +msgid "Portable Pixmap" +msgstr "" + +#: ../../recipes-images.rst:382 e6f28149321a4d0f88eb25f4d815a023 +#: fc19efb347454f39ba3255ce2c5dcba4 +msgid "PAM" +msgstr "" + +#: ../../recipes-images.rst:382 aa2dea5bd40c45af83827d5ce2faf57f +msgid "Portable Arbitrary Map" +msgstr "" + +#: ../../recipes-images.rst:383 3ce8135d2cf043658be2d15fd2eea719 +msgid "PSD" +msgstr "" + +#: ../../recipes-images.rst:383 eb23ae0a8bbc46beac03fae10c3c7a65 +msgid "Adobe Photoshop Document" +msgstr "" + +#: ../../recipes-images.rst:384 791408851dd74d809d96b6aca13c7204 +msgid "PS" +msgstr "" + +#: ../../recipes-images.rst:384 d7bf3b3685f3405991ddcc096fd258d1 +msgid "Adobe Postscript" +msgstr "" + +#: ../../recipes-images.rst:387 a23e6c5b40aa4f04be31b04c9bdf8135 +msgid "The general scheme is just the following two lines::" +msgstr "一般的なスキームは以下の2行です::" + +#: ../../recipes-images.rst:392 7329026d17f7456d9691e5f612cb615d +msgid "**Remarks**" +msgstr "**コメント**" + +#: ../../recipes-images.rst:394 6b4f390ac5df48e9847450dbe2d82683 +msgid "" +"The **input** argument of *fitz.Pixmap(arg)* can be a file or a bytes / " +"io.BytesIO object containing an image." +msgstr "`fitz.Pixmap(arg)` の入力引数は、画像を含むファイルまたはbytes/io.BytesIOオブジェクトを指定できます。" + +#: ../../recipes-images.rst:395 27a62bb79622400a910242247823f488 +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 da5ab55538834985912f6b5c5282310f +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 7903e6af6e064c82a2f4efd024c7ebba +msgid "**Convert JPEG to Photoshop**::" +msgstr "**JPEGをPhotoshopに変換する**::" + +#: ../../recipes-images.rst:405 1c975ec4e56744969ea95f9c1bc8d3c7 +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 b8924cfcc8374f7bbec53a3fa10b13f9 +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 2a98e8a8d5744bd18632923bc170a1c1 +msgid "How to Use Pixmaps: Gluing Images" +msgstr "ピクスマップの使用方法：画像の結合" + +#: ../../recipes-images.rst:431 eed91b551d8541c8b5278352edd2ef8a +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 c943c2129cc547b8924ce0d3a10e6a37 +msgid "This is the input picture:" +msgstr "これが入力画像です。" + +#: ../../recipes-images.rst:456 bddf9778332042249edc238faaa5030a +msgid "Here is the output:" +msgstr "こちらが出力結果です。" + +#: ../../recipes-images.rst:473 256f58bde8fa49dd84fb9ef279970272 +msgid "How to Use Pixmaps: Making a Fractal" +msgstr "ピクスマップの使用方法：フラクタルの作成" + +#: ../../recipes-images.rst:475 e0f6908f3f254eb58c301d0b70f5e09a +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 121c24e6a6bb42d5a13c55f1ffe69649 +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 7bf19c5cb49440a59c89cce3498c83bb +msgid "The result should look something like this:" +msgstr "結果は以下のようになるはずです：" + +#: ../../recipes-images.rst:541 503235bc579a4c479fc72819b62514a3 +msgid "How to Interface with NumPy" +msgstr "NumPyとのインターフェース方法" + +#: ../../recipes-images.rst:543 7af0fcee8cc04063900c4ea800b66583 +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 2fc27c6089214cc386c104bfde8c8021 +msgid "How to Add Images to a PDF Page" +msgstr "PDFページに画像を追加する方法" + +#: ../../recipes-images.rst:572 38d5e0833cae4b1dba86643d1c594718 +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 fbc3f8119a084993af1d81a8632628a2 +msgid "**Criterion**" +msgstr "**基準**" + +#: ../../recipes-images.rst:575 84961e2db6414203aa44e77d53e2b8a5 +msgid ":meth:`Page.insert_image`" +msgstr "" + +#: ../../recipes-images.rst:575 e8764e3de2de47d593fa0eadba0f9f4a +msgid ":meth:`Page.show_pdf_page`" +msgstr "" + +#: ../../recipes-images.rst:577 f7b45a44136042ae962e0889f2d56153 +msgid "displayable content" +msgstr "表示可能なコンテンツ" + +#: ../../recipes-images.rst:577 1da3faa72fcc4eacb95b776203ebe096 +msgid "image file, image in memory, pixmap" +msgstr "画像ファイル、メモリ内の画像、ピクスマップ " + +#: ../../recipes-images.rst:577 ed9334f1779f4b1c8d68741333d7b691 +msgid "PDF page" +msgstr "PDFページ" + +#: ../../recipes-images.rst:578 5781b34976464b8b82d47a9e3aadad63 +msgid "display resolution" +msgstr "表示解像度 " + +#: ../../recipes-images.rst:578 8170f4ab006341e5a2e020fff20f8800 +msgid "image resolution" +msgstr "画像の解像度 " + +#: ../../recipes-images.rst:578 905c22e96d4a42e793708bc27621bd42 +msgid "vectorized (except raster page content)" +msgstr "ベクトル化（ラスターページコンテンツを除く）" + +#: ../../recipes-images.rst:579 07041d4554334788b1e8690e22a87343 +msgid "rotation" +msgstr "回転" + +#: ../../recipes-images.rst:579 2957b872efe24a44b4af6c69c1a4974e +msgid "0, 90, 180 or 270 degrees" +msgstr "0度、90度、180度または270度" + +#: ../../recipes-images.rst:579 982fef9c474348749042ab67ec1a772d +msgid "any angle" +msgstr "任意の角度" + +#: ../../recipes-images.rst:580 9cbc66f2ceb24ffc8f882d6c355fd433 +msgid "clipping" +msgstr "クリッピング" + +#: ../../recipes-images.rst:580 5a0f8eca148a4b7c9fb59160fb7d4c84 +msgid "no (full image only)" +msgstr "いいえ（全体の画像のみ）" + +#: ../../recipes-images.rst:580 ../../recipes-images.rst:585 +#: 7710a9b79a72463d915283e57b459c5c d9c62bcf0fa84519a1a8b265c23b6cb2 +msgid "yes" +msgstr "はい" + +#: ../../recipes-images.rst:581 ec150921c7734e4693340657e52bc335 +msgid "keep aspect ratio" +msgstr "アスペクト比を保持" + +#: ../../recipes-images.rst:581 2fb2c5290bd145169d32ba16226ac93e +#: 5cf7c6513f364fbeb00153d359337214 +msgid "yes (default option)" +msgstr "はい（デフォルトオプション）" + +#: ../../recipes-images.rst:582 e3f9ca14ff38460a9375cfe32e4dcb6e +msgid "transparency (water marking)" +msgstr "透明性（ウォーターマーキング）" + +#: ../../recipes-images.rst:582 b1dada51af5842b8a0ec6b84b81cac47 +msgid "depends on the image" +msgstr "画像による" + +#: ../../recipes-images.rst:582 afb4e74176714873a581b3bb2e3b930c +msgid "depends on the page" +msgstr "ページによる" + +#: ../../recipes-images.rst:583 8fa93aa5ff34438b8ee50821e07159e6 +msgid "location / placement" +msgstr "位置/配置 " + +#: ../../recipes-images.rst:583 24b65150505541659cd44820067d0c92 +#: e5b8dd143ff548d4b664f4f68b9c548b +msgid "scaled to fit target rectangle" +msgstr "ターゲットの矩形にフィットするようにスケーリング" + +#: ../../recipes-images.rst:584 991fc198d121431b837d51de2e4e4f10 +msgid "performance" +msgstr "パフォーマンス" + +#: ../../recipes-images.rst:584 39885d04c43944fca9e550dbed6c87af +#: dd4de561126b41e99844d40777d478cf +msgid "automatic prevention of duplicates;" +msgstr "重複の自動防止" + +#: ../../recipes-images.rst:585 c2c88bcd5c4b4a2dbbcb17b8726b6d81 +msgid "multi-page image support" +msgstr "マルチページ画像のサポート" + +#: ../../recipes-images.rst:585 340703553b63448199dd23d0fabe074d +msgid "no" +msgstr "いいえ" + +#: ../../recipes-images.rst:586 224fb27976794268aa563e74112e487f +msgid "ease of use" +msgstr "使いやすさ" + +#: ../../recipes-images.rst:586 34992b836c0a441cb248692d0a353291 +msgid "simple, intuitive;" +msgstr "シンプルで直感的" + +#: ../../recipes-images.rst:586 739045ba0e33498694b0b6b38e29d778 +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 0c1111ac9460438db3ac68f5c575840f +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 abc6f02468414b589e83b31b25c3d7fe +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 9d7f40061f19490b9b6c4558af9cd6bf +msgid "How to Use Pixmaps: Checking Text Visibility" +msgstr "ピクスマップの使用方法：テキストの表示可否の確認" + +#: ../../recipes-images.rst:625 e5a8bbfafc3f4c98b0ddf4d0282df820 +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 dd54ade5e59344bf8a23158ab8fc5e59 +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 c1ce083c8b3b438e895adabee4596cc0 +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 5965d5042dcd4500b9d4be82702ed933 +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 18338182d8c84315879a1cb62489fb91 +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 6ac9cea943d8414f89202cbcf30f8cd5 +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 b753a5d3747a473fb889c15b3ee1dcfd +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:-1 f98b59ab6a0b47e5974952e46757f036 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/recipes-journalling.mo b/docs/locales/ja/LC_MESSAGES/recipes-journalling.mo new file mode 100644 index 000000000..67535e5c3 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/recipes-journalling.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/recipes-journalling.po b/docs/locales/ja/LC_MESSAGES/recipes-journalling.po new file mode 100644 index 000000000..3cf0b3900 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/recipes-journalling.po @@ -0,0 +1,156 @@ +# 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" + + +#: ../../recipes-journalling.rst:7 162f8e5be02b435996e936e75d7414f0 +msgid "Journalling" +msgstr "ジャーナリング" + +#: ../../recipes-journalling.rst:10 1eee3705bd8d462eb4173af15799a264 +msgid "" +"Starting with version 1.19.0, journalling is possible when updating PDF " +"documents." +msgstr "バージョン1.19.0から、PDFドキュメントの更新時にジャーナリングが可能になりました。" + +#: ../../recipes-journalling.rst:12 01d8c23d1a6b4fee91ace3858617141e +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 2828c556ba9b4cc18c6e08404a25e1b3 +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 6c7f8177f0e2439486758abb62c8fdaa +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 d108fce39ad54c9fb5a35926e9555a53 +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 731b0b3054ab40ee81ec87f68680131b +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 51c4983ea7bc43f58992c0bae8d5cef7 +msgid "" +"The journal can be **saved to** or **loaded from** a file. These are " +"document methods." +msgstr "ジャーナルはファイルに保存またはロードできます。これらはドキュメントメソッドです。" + +#: ../../recipes-journalling.rst:20 833e4734322d40c4a9635a58649d8ae5 +msgid "" +"When loading a journal file, compatibility with the document is checked " +"and journalling is automatically enabled upon success." +msgstr "ジャーナルファイルをロードする際には、ドキュメントとの互換性がチェックされ、成功した場合に自動的にジャーナリングが有効になります。" + +#: ../../recipes-journalling.rst:21 89257becd39e46e7b05a0f70ff3a6064 +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 2088a85a131f43da971a72360ceeb170 +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 f7f79e84914f4335a7d655d4d9ec4c7e +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 d2cb3c5e9b8a4f78b23dc94a089fa6b2 +msgid "Example Session 1" +msgstr "例セッション1" + +#: ../../recipes-journalling.rst:27 ../../recipes-journalling.rst:98 +#: 51bd7b4b589b463da58a23ada5e17624 56e11e17d2a849a2b774c93e4cebca91 +msgid "Description:" +msgstr "説明：" + +#: ../../recipes-journalling.rst:29 1b605ba20b944709bbb793fb850e1a0c +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 bde7498b67ac4f4aa3e84b091d6eb461 +msgid "" +"Navigate within the journal, undoing and redoing these updates and " +"displaying status and file results::" +msgstr "ジャーナル内を移動し、これらの更新を元に戻したりやり直したりし、状態やファイルの結果を表示します::" + +#: ../../recipes-journalling.rst:97 8b40e80c5f0d4027b8aaf4ba8e4285e3 +msgid "Example Session 2" +msgstr "例セッション2" + +#: ../../recipes-journalling.rst:100 43ff667b4170420aaacce401a500d0d3 +msgid "" +"Similar to previous, but after undoing some operations, we now add a " +"different update. This will cause:" +msgstr "前回と同様ですが、いくつかの操作を元に戻した後、異なる更新を追加します。これにより、次のことが起こります：" + +#: ../../recipes-journalling.rst:102 2c6008fe73da4e918fcf48f47c04f253 +msgid "permanent removal of the undone journal entries" +msgstr "元に戻されたジャーナルエントリが永久に削除されます。" + +#: ../../recipes-journalling.rst:103 942072c04f294bf49dd11bb76b282a2c +msgid "the new update operation will become the new last entry." +msgstr "新しい更新操作は新しい最後のエントリになります。" + +#: ../../footer.rst:-1 f6d68aef909b42f597860e55087ba121 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/recipes-low-level-interfaces.mo b/docs/locales/ja/LC_MESSAGES/recipes-low-level-interfaces.mo new file mode 100644 index 000000000..31abb5369 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/recipes-low-level-interfaces.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/recipes-low-level-interfaces.po b/docs/locales/ja/LC_MESSAGES/recipes-low-level-interfaces.po new file mode 100644 index 000000000..d9a52b252 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/recipes-low-level-interfaces.po @@ -0,0 +1,493 @@ +# 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" + +#: ../../recipes-low-level-interfaces.rst:7 e09f2375a4ee4cea9458faf911c92464 +msgid "Low-Level Interfaces" +msgstr "低レベルインターフェース" + +#: ../../recipes-low-level-interfaces.rst:10 eea15913992b47c59d8c238808ef2475 +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 8319b3a3f27e4c389cd8a2761e7eac46 +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 977f74050ca649d29c6d828f7a9ad25b +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 328e75fc36664019bf3536219a4bcbc4 +msgid "How to Iterate through the :data:`xref` Table" +msgstr ":data:`xref` テーブルのイテレーション方法" + +#: ../../recipes-low-level-interfaces.rst:20 dc1b59dd7e3a4d0c8e7dc3e9f7d922de +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 604bd3b0a0a14cfbb027b31df59caeb9 +msgid "This produces the following output::" +msgstr "これにより、以下の出力が生成されます::" + +#: ../../recipes-low-level-interfaces.rst:72 198801935cdd4e0293b1ecd0993ea1f0 +msgid "A PDF object definition is an ordinary ASCII string." +msgstr "PDFオブジェクトの定義は通常のASCII文字列です。" + +#: ../../recipes-low-level-interfaces.rst:77 efd90be1a9424b2d8d7cded8ad33403c +msgid "How to Handle Object Streams" +msgstr "オブジェクトストリームの処理方法" + +#: ../../recipes-low-level-interfaces.rst:78 2203ce1aff18423484c8cd9fe2833eae +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 bdf64a7f3e834596b7ae2377cca35e0a +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 82aea75e2e864e40842c78805d7e2934 +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 6f53785a9a1a4e4cb14eb334cf79d49d +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 0ffa71e932dc44ef83175f03e26ccc7d +msgid "How to Handle Page Contents" +msgstr "ページ内容の処理方法" + +#: ../../recipes-low-level-interfaces.rst:97 22c450a5665d46bbb222376a7d9ca4d2 +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 902e1c6fde394c83ae9cb6ca91af3e2e +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 64fba788c79e48e596a6a790f472e26b +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 0231ba52b65d42b48dd0816d2070e58b +msgid "" +"There are good technical arguments for having multiple :data:`contents` " +"objects:" +msgstr "複数の :data:`contents` オブジェクトを持つメリットには、次のような良い技術的理由があります：" + +#: ../../recipes-low-level-interfaces.rst:105 a06b280e348841e092e18bd6dc5341e1 +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 9b76d3e0cf844d41ae9aa574c8a4dfcf +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 070251b87c5b4030863a5faf67589836 +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 46e7fce1edc04b73bc6491afd646bd39 +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 9fcb5c2ac66c4318bef152d605f31fb0 +msgid "Here are two ways of combining multiple contents of a page::" +msgstr "以下は、ページの複数のコンテンツを組み合わせる2つの方法です：" + +#: ../../recipes-low-level-interfaces.rst:124 97e64f532f9b497488430e3c4e8c4995 +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 522768154d0f41e2abdbaefbf4115396 +msgid "How to Access the PDF Catalog" +msgstr "PDFカタログへのアクセス方法" + +#: ../../recipes-low-level-interfaces.rst:130 aaaf28dac6f241ff9414c128615db043 +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 325476f21312499aa5b8d290a317d80b +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 d3ad389ecea74c0991643a38d5c7f24f +msgid "How to Access the PDF File Trailer" +msgstr "PDFファイルトレーラーへのアクセス方法" + +#: ../../recipes-low-level-interfaces.rst:152 01d578f095a84038b9937752bc929b40 +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 f86b2bcafb4f41fd89054d5a345eb6e9 +msgid "**Key**" +msgstr "**キー**" + +#: ../../recipes-low-level-interfaces.rst:155 163e9c7263814095a568e7da3ae7a471 +msgid "**Type**" +msgstr "**タイプ**" + +#: ../../recipes-low-level-interfaces.rst:155 f181f79a876745a2924b262290d9b836 +msgid "**Value**" +msgstr "" + +#: ../../recipes-low-level-interfaces.rst:157 e6220f7ad7204316b1135530388b80e2 +msgid "Size" +msgstr "**値**" + +#: ../../recipes-low-level-interfaces.rst:157 +#: ../../recipes-low-level-interfaces.rst:158 +#: ../../recipes-low-level-interfaces.rst:163 16bb5aec66254d36b2f4eb5db40c4d9c +#: af78f5f78d3a46f990dbde393034fdd3 e9bfb125dc284bbb89bcf92e2a7e9438 +msgid "int" +msgstr "" + +#: ../../recipes-low-level-interfaces.rst:157 3ea703956c064f289b9f917f85501deb +msgid "Number of entries in the cross-reference table + 1." +msgstr "クロスリファレンステーブル内のエントリ数 + 1 の数値。" + +#: ../../recipes-low-level-interfaces.rst:158 53c5bb092a7040948bd997d39d2768f9 +msgid "Prev" +msgstr "" + +#: ../../recipes-low-level-interfaces.rst:158 5e90798bdf1c49f8bd2808c7eabf6743 +msgid "Offset to previous :data:`xref` section (indicates incremental updates)." +msgstr "前の :data:`xref` セクションへのオフセット（増分更新を示す）。" + +#: ../../recipes-low-level-interfaces.rst:159 69279ef6e1d643c7ac2aadbb463faff2 +msgid "Root" +msgstr "" + +#: ../../recipes-low-level-interfaces.rst:159 +#: ../../recipes-low-level-interfaces.rst:160 +#: ../../recipes-low-level-interfaces.rst:161 57eab9c4aaa24925830e7d6d736ba7ea +#: a4d56c17edda4a438648d478ff82bf10 b5913d197dd64670be8485d9290df33b +msgid "dictionary" +msgstr "" + +#: ../../recipes-low-level-interfaces.rst:159 c553d8a221b3401b926f4119c4f0138b +msgid "(indirect) Pointer to the catalog. See previous section." +msgstr "(間接的) カタログへのポインタ。前のセクションを参照してください。" + +#: ../../recipes-low-level-interfaces.rst:160 3846f851779f46f5ad6bc94fab138d26 +msgid "Encrypt" +msgstr "" + +#: ../../recipes-low-level-interfaces.rst:160 559af29fc24d426ab4027ee40f45bd57 +msgid "Pointer to encryption object (encrypted files only)." +msgstr "(暗号化されたファイルのみ) 暗号化オブジェクトへのポインタ。" + +#: ../../recipes-low-level-interfaces.rst:161 e1d96f80faff4b69b17c3d02d0e7e62a +msgid "Info" +msgstr "" + +#: ../../recipes-low-level-interfaces.rst:161 979a89eacf424ee7b7e2d87e19a0aecd +msgid "(indirect) Pointer to information (metadata)." +msgstr "(間接的) 情報（メタデータ）へのポインタ。" + +#: ../../recipes-low-level-interfaces.rst:162 67931111f2b44088b1dc2c730639cdaf +msgid "ID" +msgstr "" + +#: ../../recipes-low-level-interfaces.rst:162 cbacbc116cb945bc9fd21dc5c25368f9 +msgid "array" +msgstr "" + +#: ../../recipes-low-level-interfaces.rst:162 694ef829394d48d2a3efd0bab03f54e4 +msgid "File identifier consisting of two byte strings." +msgstr "2つのバイト文字列からなるファイル識別子。" + +#: ../../recipes-low-level-interfaces.rst:163 6be7ffab33d645dbbc8ec3635da4a320 +msgid "XRefStm" +msgstr "" + +#: ../../recipes-low-level-interfaces.rst:163 deae6c96b52a4ff3a3d2e6a9cdaf4e91 +msgid "Offset of a cross-reference stream. See :ref:`AdobeManual` p. 49." +msgstr "クロスリファレンスストリームのオフセット。:ref:`AdobeManual` を参照してください（p. 49）。" + +#: ../../recipes-low-level-interfaces.rst:166 56d9a2fe89274c6eb434cb3d1a8c54a3 +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 d1f61c8f34a04b1fbc1480cef879e9ac +msgid "How to Access XML Metadata" +msgstr "XMLメタデータへのアクセス方法" + +#: ../../recipes-low-level-interfaces.rst:188 c6f3c7ef439144d0a07d36e201fbea78 +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 78f7d72f5dff4af590c33962d60eb698 +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 21c18bda22ab4472b30e2418100e33e8 +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 6c3e51c6336444c5b9c9cf8921bec2a2 +msgid "How to Extend PDF Metadata" +msgstr "PDFメタデータの拡張方法" + +#: ../../recipes-low-level-interfaces.rst:214 287962e32da3408480072b8e9f096e06 +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 4ff4b26897614d4eaa5869742e0431e6 +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 f7b20535b67e4618aad30461809f3763 +msgid "As an example, look at this standard metadata output of some PDF::" +msgstr "例として、次のPDFの標準メタデータ出力をご覧ください::" + +#: ../../recipes-low-level-interfaces.rst:237 5fad75b9a2e244c88d774909b055d955 +msgid "" +"Use the following code to see **all items** stored in the metadata " +"object::" +msgstr "以下のコードを使用して、メタデータオブジェクトに保存されているすべてのアイテムを表示します::" + +#: ../../recipes-low-level-interfaces.rst:265 1b1322449ace423c9fdd919911c72c13 +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 9c7a8244e36545518195d0af316c1b29 +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 ca1b8ec182f742f9a8f08ca017407850 +msgid "How to Read and Update PDF Objects" +msgstr "PDFオブジェクトの読み取りと更新方法" + +#: ../../recipes-low-level-interfaces.rst:297 5d7474dd7b6d437a8ab90761717ff821 +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 c01c5f59a1554db9b2e568c242523a12 +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 bbbd2788f0194c74a5826bf0e77584f9 +msgid "Compare with the full object definition::" +msgstr "完全なオブジェクト定義と比較してください::" + +#: ../../recipes-low-level-interfaces.rst:319 309c5cbc937945a98d417485170b78a6 +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 8eb1d853dc85481da22571c9fc8c5966 +msgid "Here is a full listing of the above page keys::" +msgstr "以下は、上記のページキーの完全な一覧です::" + +#: ../../recipes-low-level-interfaces.rst:335 8b25b152b64c4c87982f4168596e570e +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 b2dacc6479934ffb81d936408fd09bf8 +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 e4731c11053e4b85b03a2ea1a8091489 +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 aa0ae52d500849eea8528534fe46a7d9 +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 39741dd9982d4e8eb37f37e2fc5c2a86 +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 5b9b7a745b9d4678983b7cbb8e6787fd +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 42fb7460a28a4686953e696e6dba7bb2 +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 217e666036d0405c9466c9b06b7000ea +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 e83f6356ec65419ea2e0f6a43d0e80ae +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 769fa65a55e04504b807e04884bbf11f +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 87d6fdda109240b091205b2b49c20f11 +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:-1 caa4fff6e17f4026b0b545993ec021ec +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/recipes-multiprocessing.mo b/docs/locales/ja/LC_MESSAGES/recipes-multiprocessing.mo new file mode 100644 index 000000000..d839d50f5 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/recipes-multiprocessing.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/recipes-multiprocessing.po b/docs/locales/ja/LC_MESSAGES/recipes-multiprocessing.po new file mode 100644 index 000000000..cf024cc2b --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/recipes-multiprocessing.po @@ -0,0 +1,77 @@ +# 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" + +#: ../../recipes-multiprocessing.rst:17 a41b9b820ea541f0b9f6106a792c880a +msgid "Multiprocessing" +msgstr "マルチプロセッシング" + +#: ../../recipes-multiprocessing.rst:19 abd4e5ff2d674c0ebb9c3dc6d0e91745 +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 " +":title:`PyMuPDF` is:" +msgstr ":title:`MuPDF` はスレッディングに対する統合サポートを持っておらず、「スレッドに対して無関心（thread-agnostic）」と呼ばれています。MuPDFとスレッディングを組み合わせて使用するトリッキーな可能性は存在しますが、PyMuPDFの基本的な影響は次のとおりです：" + +#: ../../recipes-multiprocessing.rst:21 d03018a0dea548148df2c97b7a7c06c3 +msgid "**No Python threading support**." +msgstr "**Pythonスレッディングのサポートはありません。**." + +#: ../../recipes-multiprocessing.rst:23 c09b5e9257d94c469ec5864b3ab8f026 +msgid "" +"Using :title:`PyMuPDF` in a :title:`Python` threading environment will " +"lead to blocking effects for the main thread." +msgstr ":title:`PyMuPDF` を :title:`Python` スレッディング環境で使用すると、メインスレッドでのブロッキング効果が発生します。" + +#: ../../recipes-multiprocessing.rst:25 be2d2d0701654a9fab53ddcd69d659f7 +msgid "" +"However, there is the option to use :title:`Python's` *multiprocessing* " +"module in a variety of ways." +msgstr "ただし、Pythonのmultiprocessingモジュールをさまざまな方法で使用するオプションがあります。" + +#: ../../recipes-multiprocessing.rst:27 d69a8a48ef284a289d0f7c21a2faf8a3 +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:30 ../../recipes-multiprocessing.rst:41 +#: 97aa34ddd91a43799f218b60cb6d5118 d8082d11f2f748f6ab8db930723daaa5 +msgid "|toggleStart|" +msgstr "" + +#: ../../recipes-multiprocessing.rst:35 ../../recipes-multiprocessing.rst:46 +#: 656d732fe0444d069b6fc92f2ad2ea1a e106f2a005044043a9934ff547d3f97f +msgid "|toggleEnd|" +msgstr "" + +#: ../../recipes-multiprocessing.rst:38 ec0ea998b3a84fe09f5769602ec421f1 +msgid "" +"Here is a more complex example involving inter-process communication " +"between a main process (showing a GUI) and a child process doing " +":title:`PyMuPDF` access to a document." +msgstr "以下は、メインプロセス（GUIを表示）とドキュメントへのPyMuPDFアクセスを行う子プロセスとの間のプロセス間通信を含む、より複雑な例です。" + +#: ../../footer.rst:-1 109bfb6fe9f94ac99f3f31045bbf6a2f +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/recipes-optional-content.mo b/docs/locales/ja/LC_MESSAGES/recipes-optional-content.mo new file mode 100644 index 000000000..e402ecf4c Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/recipes-optional-content.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/recipes-optional-content.po b/docs/locales/ja/LC_MESSAGES/recipes-optional-content.po new file mode 100644 index 000000000..d42bcb828 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/recipes-optional-content.po @@ -0,0 +1,176 @@ +# 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" + +#: ../../recipes-optional-content.rst:7 0a2ebcb1d8dd4929bc6a7bab9e328d20 +msgid "Optional Content Support" +msgstr "オプションコンテンツのサポート" + +#: ../../recipes-optional-content.rst:9 e8d13546904a43798d1684867934d1fe +msgid "" +"This document explains PyMuPDF's support of the PDF concept **\"Optional " +"Content\"**." +msgstr "この文書では、PyMuPDFにおけるPDFコンセプト **「オプションコンテンツ」** のサポートについて説明します。" + +#: ../../recipes-optional-content.rst:12 9e83bcfacacf4fd6866cb3e296cb2506 +msgid "Introduction: The Optional Content Concept" +msgstr "はじめに：オプションコンテンツのコンセプト" + +#: ../../recipes-optional-content.rst:13 a61165d1b6234dd798a42adcc7997feb +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 6778d30c70b84214a70aa39de3c45f82 +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 240857aa9aa643ba98408d062734036e +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 f37418abc0ae4ede8d74c9ce0d70ffe0 +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 14925cc738fe4be3a316af47bb1362cc +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 c371955523ef4a5c94ba3728c8238388 +msgid "Except for the default one, OC Configurations are optional." +msgstr "デフォルト以外のOC構成はオプションです。" + +#: ../../recipes-optional-content.rst:25 6df952cbba124f249c2c149882fd65bf +msgid "" +"For more explanations and additional background please refer to PDF " +"specification manuals." +msgstr "詳細な説明や追加の背景情報については、PDF仕様マニュアルを参照してください。" + +#: ../../recipes-optional-content.rst:28 601b3d28a96746cbb86236b6ce714002 +msgid "PyMuPDF Support for PDF Optional Content" +msgstr "PDFオプショナルコンテンツのPyMuPDFサポート" + +#: ../../recipes-optional-content.rst:29 e8ef216bcfba4ee39b7e3165c4b084f7 +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 65bdb7b422de445abfee6361ee158947 +msgid "How to Add Optional Content" +msgstr "オプショナルコンテンツの追加方法" + +#: ../../recipes-optional-content.rst:33 d239261fbbed4f8b8b74aecfb5cb1df6 +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 5c962eafc8054b83a3f9fa1d25f8ae75 +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 69183952bf9e40ef821b0261ed879143 +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 985cdb24d5414a538bffa837f761ed6b +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 eea3800d885b4bc5808e9bd861947b90 +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 86ce7d5f3561482382bebb96e87ce802 +msgid "" +"One single OCG can be assigned to mutiple PDF objects to control their " +"visibility." +msgstr "1つのOCGは複数のPDFオブジェクトに割り当てて、それらの可視性を制御することができます。" + +#: ../../recipes-optional-content.rst:48 b3c3de4f1cf540ac9cec0ca4ec8f42ba +msgid "How to Define Complex Optional Content Conditions" +msgstr "複雑なオプショナルコンテンツ条件の定義方法" + +#: ../../recipes-optional-content.rst:50 2543d16742ab43b9823e0d087fb0c0f9 +msgid "" +"Sophisticated logical conditions can be established to address complex " +"visibility needs." +msgstr "複雑な可視性のニーズに対応するために、洗練された論理条件を設定することができます。" + +#: ../../recipes-optional-content.rst:52 4112ff01c8924de5a6f0d3a6fb3a4ac2 +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 f55ad21e47834314bdd1d63a8bdd0a26 +msgid "Please have a look at `this Jupyter Notebook`_ and execute it as desired." +msgstr "`この Jupyter Notebook `_ をご覧いただき、必要に応じて実行してみてください。" + +#: ../../recipes-optional-content.rst:56 6959334a835a44a29beafc76a3256764 +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:-1 66fed95c5d5046788ab03114ba13b75c +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/recipes-stories.mo b/docs/locales/ja/LC_MESSAGES/recipes-stories.mo new file mode 100644 index 000000000..e08ae9f4f Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/recipes-stories.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/recipes-stories.po b/docs/locales/ja/LC_MESSAGES/recipes-stories.po new file mode 100644 index 000000000..a4ea54628 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/recipes-stories.po @@ -0,0 +1,651 @@ +# 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" + + +#: ../../recipes-stories.rst:17 28ada3de6a654f38882d1f2e190359b8 +msgid "Stories" +msgstr "ストーリーズ" + +#: ../../recipes-stories.rst:19 4a5e466ecf6e4ba29e5651c8011b02d7 +msgid "" +"This document showcases some typical use cases for " +":ref:`Stories`." +msgstr "このドキュメントは、 :ref:`ストーリーズ` の典型的な使用例を示しています。" + +#: ../../recipes-stories.rst:21 f1f2a79aa9d945918c12b900f382e404 +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:23 fa4322d46ab44e92b8a4a4d1fad103f3 +msgid "The following examples will showcase combinations for using these inputs." +msgstr "以下の例では、これらの入力を使用した組み合わせを示します。" + +#: ../../recipes-stories.rst:27 dc0761ef286442a9ba201027745b300c +msgid "" +"Many of these recipe's source code are included as examples in the `docs`" +" folder." +msgstr "これらのレシピのソースコードの多くは、ドキュメントフォルダ内の例として含まれています。" + +#: ../../recipes-stories.rst:33 6deb22cb00ec41ebb34ad2ef3f21f21b +msgid "How to Add a Line of Text with Some Formatting" +msgstr "テキストの行をいくつかの書式で追加する方法" + +#: ../../recipes-stories.rst:35 e2b68ab93436401f85921e27c3a86f1f +msgid "Here is the inevitable \"Hello World\" example. We will show two variants:" +msgstr "以下は、避けられない「Hello World」の例です。2つのバリアントを示します：" + +#: ../../recipes-stories.rst:37 da2f0c49ec6241b08a9efad8b6afde8d +msgid "Create using existing HTML source [#f1]_, that may come from anywhere." +msgstr "どこからでも取得できる既存のHTMLソース [#f1]_ を使用して作成します。" + +#: ../../recipes-stories.rst:38 124131944f7846ec812df189cdc95c45 +msgid "Create using the Python API." +msgstr "Python APIを使用して作成します。" + +#: ../../recipes-stories.rst:42 9286166972e24c34b3b7fafb31f5bcca +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:68 9bbd51df483247e580e231390e560ffb +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:89 b60da131ba6b4280bb6f05e75d7bde34 +msgid "The Python API variant -- everything is created programmatically::" +msgstr "Python APIのバリアント - すべてがプログラムで作成されます::" + +#: ../../recipes-stories.rst:113 4b35d30c975b4abc9604b0490eb82d60 +msgid "Both variants will produce the same output PDF." +msgstr "どちらのバリアントも同じ出力のPDFを生成します。" + +#: ../../recipes-stories.rst:121 16df57d23462442c809cad549f33f4c8 +msgid "How to use Images" +msgstr "画像の使用方法" + +#: ../../recipes-stories.rst:123 2fc054034c55475a9218b714910d9629 +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:125 21e3c6e018304a63bd04ab3da74b044b +msgid "" +"Images with the binary content embedded in the HTML source are **not " +"supported** by stories." +msgstr "HTMLソースにバイナリコンテンツが埋め込まれた画像は、ストーリーズではサポートされていません。" + +#: ../../recipes-stories.rst:127 da914d01e51543ae8d92d8cd9626feba +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:167 f29eb9cbabda4491a8ce80d636d4fad1 +msgid "How to Read External HTML and CSS for a Story" +msgstr "外部のHTMLとCSSをストーリーに読み込む方法" + +#: ../../recipes-stories.rst:169 2835214b044c42228828a4bb4c80f906 +msgid "These cases are fairly straightforward." +msgstr "これらのケースはかなり直接的です。" + +#: ../../recipes-stories.rst:171 1c41f85a3f824d268b74bbbe468fbe16 +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:192 89a987ee84be42a4810bd8eb41bcc451 +msgid "How to Output Database Content with Story Templates" +msgstr "データベースの内容をストーリーテンプレートで出力する方法" + +#: ../../recipes-stories.rst:194 02a4ba3869cc4aca8c265abf6711d1bd +msgid "" +"This script demonstrates how to report SQL database content using an " +"**HTML template**." +msgstr "このスクリプトは**HTMLテンプレート**を使用してSQLデータベースの内容を報告する方法を示しています。" + +#: ../../recipes-stories.rst:198 a5f4f01135b5451abf97ea06dafdfe5d +msgid "The example SQL database contains two tables:" +msgstr "この例のSQLデータベースには2つのテーブルが含まれています：" + +#: ../../recipes-stories.rst:200 14372fbf3f2b4a1889dba648c5a97e43 +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:201 f13ed99ec3214ecfa2ccdf8e53c561e7 +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:203 f1506542fd504354b86a5abc3a3ee592 +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:205 ../../recipes-stories.rst:230 +#: ../../recipes-stories.rst:256 ../../recipes-stories.rst:308 +#: ../../recipes-stories.rst:342 ../../recipes-stories.rst:376 +#: ../../recipes-stories.rst:397 ../../recipes-stories.rst:432 +#: ../../recipes-stories.rst:466 ../../recipes-stories.rst:496 +#: ../../recipes-stories.rst:530 6924a729eae149b886ddbdcfdf99611f +#: 6d78c7f5d408434388ea652c9f3ee428 6ee90885bd9c4161ac928657395c3f51 +#: 6fe18168e66347da8736ea5bcddabdb0 71822ebb16aa4f48a20469bbcecc3d62 +#: 84c6eff38c35411ab11fa3f39196a20e 9bd53af181f34632be1b4badf9fb0ea8 +#: b2b8393edab34bb1a9139d93e31d561d c3b354c4bd6845ed96988fb86c2aba18 +#: d2620d4ed490427f8639c91c7ceaa8ae ea7c17028a53439b84d0422e13f04f23 +msgid "**Files:**" +msgstr "**ファイル：**" + +#: ../../recipes-stories.rst:207 a53ab4e888384172b14f88c5f25789ad +msgid "`docs/samples/filmfestival-sql.py`" +msgstr "" + +#: ../../recipes-stories.rst:208 867991edcf3443dc858b0c9bc5ce616d +msgid "`docs/samples/filmfestival-sql.db`" +msgstr "" + +#: ../../recipes-stories.rst:211 ../../recipes-stories.rst:234 +#: ../../recipes-stories.rst:262 ../../recipes-stories.rst:315 +#: ../../recipes-stories.rst:346 ../../recipes-stories.rst:359 +#: ../../recipes-stories.rst:380 ../../recipes-stories.rst:401 +#: ../../recipes-stories.rst:436 ../../recipes-stories.rst:470 +#: ../../recipes-stories.rst:500 ../../recipes-stories.rst:534 +#: 01558bc813da4f4fb0b2e52caf655892 02170238809f4b8db4b3f4d99e53fd04 +#: 1a3f1a7a3ba3468fa934867a3519ba86 2044e44f6af74eac9dee9935aa4f28cc +#: 25f6473c8e3d4f4492de99be854bc14d 30ab0daafb8f4f2ba463e436aa4c8315 +#: 6d0f6aa8ac204a00a83f0a1cd895996d 6ef1877292b34194b210b8a1333f47ff +#: 72cf5532eb4d46cc9df855e8a196c00c a19de32ecce54fa19812ab280b44f8f8 +#: bc3d2b005a974c4a82f174170f10fc87 d0aa0e205f414ff4a3b4410189bbd8cd +msgid "|toggleStart|" +msgstr "" + +#: ../../recipes-stories.rst:215 ../../recipes-stories.rst:238 +#: ../../recipes-stories.rst:266 ../../recipes-stories.rst:319 +#: ../../recipes-stories.rst:350 ../../recipes-stories.rst:363 +#: ../../recipes-stories.rst:384 ../../recipes-stories.rst:405 +#: ../../recipes-stories.rst:440 ../../recipes-stories.rst:474 +#: ../../recipes-stories.rst:504 ../../recipes-stories.rst:538 +#: 10b5086634de444eb73486a4ab2e7492 33a2a0470093488d9f1587992d4f3f4b +#: 8c9ca856400f49a4b0f544d734be7ff5 97368b6040a4435a881a70c272be7aee +#: a40ae4e40d9646828430eb412e5e88ad ae3bae90994d4b9b960dbadd1cd4922f +#: aef9e577b4c940149e1111d239115841 bca9bc770efc4ca081ca953c06e08525 +#: c388daa47235452d8cc3137559303c11 c9fb71f5e06c497b90678e1a747b0a08 +#: cadd1c06b50e494c9bfc03cf0ef8c311 fab6796dd92f48099f4571c5b7f05c54 +msgid "|toggleEnd|" +msgstr "" + +#: ../../recipes-stories.rst:224 56f450b98412449bb9c89b82bb3ed20f +msgid "How to Integrate with Existing PDFs" +msgstr "既存のPDFと統合する方法" + +#: ../../recipes-stories.rst:226 51c54f53e4564e739d548e0f6edf9525 +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:228 0ac1e1ae4d824d71a35006c0b2642145 +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:232 d0cfcfcd6b424271ab1db9c82914e9a5 +msgid "`docs/samples/showpdf-page.py`" +msgstr "" + +#: ../../recipes-stories.rst:247 76e6407e25aa48b8a39fc24e06eeb54a +msgid "" +"How to Make Multi-Columned Layouts and Access Fonts from Package " +"`pymupdf-fonts`_" +msgstr "多段組のレイアウトを作成し、パッケージ `pymupdf-fonts`_ からフォントにアクセスする方法" + +#: ../../recipes-stories.rst:249 bcd5309dfd49461fae6d3683d651cef2 +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:251 33d073eca57d4921bdef301dd6d0a7a7 +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:253 9c0e0087e174497ab5a5043e373502e2 +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:258 d3a76a88b04642b693346dcf29869962 +msgid "`docs/samples/quickfox.py`" +msgstr "" + +#: ../../recipes-stories.rst:259 ../../recipes-stories.rst:312 +#: 5bdd3ed940c74ce6a49858ee88d9adb5 fbd814f6496641babc7b500b4518326c +msgid "`docs/samples/quickfox.zip`" +msgstr "" + +#: ../../recipes-stories.rst:275 5d45cc01a6a04968bf95a67b155e7c43 +msgid "How to Make a Layout which Wraps Around a Predefined \"no go area\" Layout" +msgstr "あらかじめ定義された「禁止エリア」レイアウトに囲まれたレイアウトの作成方法" + +#: ../../recipes-stories.rst:278 69aaae27c4b247dd92db646de84444c1 +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:281 02db826eb07d4300a0e0ca009568c75a +msgid "The script demonstrates the following features:" +msgstr "このスクリプトは、以下の機能を示しています：" + +#: ../../recipes-stories.rst:283 c5d78e3867844aa99ae07cbb50020d8e +msgid "Layout text around images of an existing (\"target\") PDF." +msgstr "既存の（「ターゲット」）PDFの画像の周りにテキストをレイアウトします。" + +#: ../../recipes-stories.rst:284 0863f27c786f440ba8366f8ffd70f726 +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:286 86d604149e244d36a8ca3e97c6d9269d +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:289 7cdf080e1e3740489646a6dcb4a8e387 +msgid "The width of the border(s) on each page." +msgstr "各ページのボーダーの幅。" + +#: ../../recipes-stories.rst:290 a58fe0798d484ba598fda59607a6c732 +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:296 677141ed2019410db05c3b9550bd0bac +msgid "Use of a 2-column page layout for the text." +msgstr "テキストのための2列のページレイアウトの使用。" + +#: ../../recipes-stories.rst:297 3607c5d85e75473a86b22a06e8ad7883 +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:301 959025d085a441b9a05f1c799f4bc8d5 +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:305 5b80bcc620a04d319b144fd9f91d6622 +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:310 685b48da357a4f5eb32b28f331525b38 +msgid "`docs/samples/quickfox-image-no-go.py`" +msgstr "" + +#: ../../recipes-stories.rst:311 4dab03463c014d8b80d8ee98a266daaf +msgid "`docs/samples/quickfox-image-no-go.pdf`" +msgstr "" + +#: ../../recipes-stories.rst:328 d93c027640cb4d4fbb52bc2c4c0c90a5 +msgid "How to Output an HTML Table" +msgstr "HTMLテーブルの出力方法" + +#: ../../recipes-stories.rst:330 e36b556428fe43e5980952e86d31d8d2 +msgid "Outputting HTML tables is supported as follows:" +msgstr "HTMLテーブルの出力は次のようにサポートされています：" + +#: ../../recipes-stories.rst:332 74aa77ec0a804627be39a86db6c10e59 +msgid "" +"Flat table layouts are supported (\"rows x columns\"), no support of the " +"\"colspan\" / \"rowspan\" attributes." +msgstr "フラットなテーブルレイアウト（「行 × 列」）がサポートされており、「colspan」/「rowspan」属性はサポートされていません。" + +#: ../../recipes-stories.rst:333 5d82a416466f4aa48b16fd691f60a57b +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:334 b1d7f56d7f824c95bb8a151b18ca09bb +msgid "" +"Column widths are computed automatically based on column content. They " +"cannot be directly set." +msgstr "列の幅は、列のコンテンツに基づいて自動的に計算されます。直接設定することはできません。" + +#: ../../recipes-stories.rst:335 d83059ef35f94da190cf995936c13fa3 +msgid "" +"Table **cells may contain images** which will be considered in the column" +" width calculation magic." +msgstr "テーブルのセルには画像を含めることができ、これは列幅計算の際に考慮されます。" + +#: ../../recipes-stories.rst:336 a53313c7ace04aaf888510ef6ae684f7 +msgid "" +"Row heights are computed automatically based on row content - leading to " +"multi-line rows where needed." +msgstr "行の高さは、行のコンテンツに基づいて自動的に計算され、必要に応じて複数行の行が生成されます。" + +#: ../../recipes-stories.rst:337 4dab3da90acf4e08841f4ad93ed4da31 +msgid "" +"The potentially multiple lines of a table row will always be kept " +"together on one page (respectively \"where\" rectangle) and not be " +"splitted." +msgstr "テーブルの行の潜在的に複数行は、常に1つのページ（または “where” 矩形）にまとめて表示され、分割されることはありません。" + +#: ../../recipes-stories.rst:338 51c731f0c57143cd80b5f734e3239b66 +msgid "" +"Table header rows are only **shown on the first page / \"where\" " +"rectangle.**" +msgstr "テーブルのヘッダー行は、最初のページ / \"where\" 矩形のみに表示されます。" + +#: ../../recipes-stories.rst:339 e32cc714dfce441eb317ae6aca9bac62 +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:340 6dd2011aebd542e4a871f813d4b3c8d8 +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:344 cf108b7f7bcb405f93e678820fa0bb05 +msgid "`docs/samples/table01.py` This script reflects basic features." +msgstr "`docs/samples/table01.py` このスクリプトは基本的な機能を反映しています。" + +#: ../../recipes-stories.rst:352 684ed0b5ee4e4c53a928e618d28ff430 +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:354 20727b3c9a494daeb37fec69a2700e0c +msgid "Multi-page output simulating **repeating header rows**" +msgstr "繰り返しヘッダー行をシミュレートするマルチページ出力" + +#: ../../recipes-stories.rst:355 628eed1f62ae40ab8fa2ee5ed012485e +msgid "Alternating table row background colors" +msgstr "交互のテーブル行の背景色" + +#: ../../recipes-stories.rst:356 dd09175092344e4cbdf8a3639466b9ca +msgid "Table rows and columns delimited by gridlines" +msgstr "グリッドラインで区切られたテーブル行と列" + +#: ../../recipes-stories.rst:357 a306f67d8ae24d918fd368a0f928fb8b +msgid "Table rows dynamically generated / filled with data from an SQL database" +msgstr "SQLデータベースからデータを動的に生成/埋めるテーブル行" + +#: ../../recipes-stories.rst:372 a7af05e9dc4144548768175f83ed1553 +msgid "How to Create a Simple Grid Layout" +msgstr "シンプルなグリッドレイアウトの作成方法" + +#: ../../recipes-stories.rst:374 f91a89ba8df349d1847bdc47d01951ec +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:378 851130b963f64978801bd208fea6fb3a +msgid "`docs/samples/simple-grid.py`" +msgstr "" + +#: ../../recipes-stories.rst:393 9ba1df00e0b24c0b80dbaef830287245 +msgid "How to Generate a Table of Contents" +msgstr "目次の生成方法" + +#: ../../recipes-stories.rst:395 eb6d9c50063242fcbbe4a0e85e60cfc1 +msgid "" +"This script lists the source code of all Python scripts that live in the " +"script's directory." +msgstr "このスクリプトは、スクリプトのディレクトリに存在するすべてのPythonスクリプトのソースコードをリスト表示します。" + +#: ../../recipes-stories.rst:399 5328c3155d1945d6b22ada16141d851e +msgid "`docs/samples/code-printer.py`" +msgstr "" + +#: ../../recipes-stories.rst:408 88da096fdae14712acc5a9f105c3845e +msgid "It features the following capabilities:" +msgstr "次の機能が備わっています：" + +#: ../../recipes-stories.rst:410 c38f87acb23e45ab964c1db45e63308c +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:412 c3cb004d4878410c840a617760439c8a +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:414 9c7e3c72f3ea40ec84e72e661ab9cba5 +msgid "" +"The page **footer is automatically changed** to show the name of the " +"current Python file." +msgstr "ページフッターは自動的に変更され、現在のPythonファイル名が表示されます。" + +#: ../../recipes-stories.rst:416 7909066f72c94941ba9c2a6aab90dfc9 +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:418 b0f4ea235363418f955d21618bbcd43c +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:427 23b665b036774c0d9472b5009ca27537 +msgid "How to Display a List from JSON Data" +msgstr "JSONデータからリストを表示する方法" + +#: ../../recipes-stories.rst:429 93da94aeb4fd4b9293da658bf1adabe1 +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:434 7bc6ba6d06174f2583b4044343702885 +msgid "`docs/samples/json-example.py`" +msgstr "" + +#: ../../recipes-stories.rst:450 61ca949a83064c5aac68c36d3ab3f1f0 +msgid "Using the Alternative :meth:`Story.write*()` functions" +msgstr ":meth:`Story.write*()` 関数の使用方法" + +#: ../../recipes-stories.rst:452 7f15bd89030244819f14311422c997b6 +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:461 7ef6f9e0e6044648b8c519713059c2d1 +msgid "How to do Basic Layout with :meth:`Story.write()`" +msgstr ":meth:`Story.write()` を使用した基本的なレイアウトの方法" + +#: ../../recipes-stories.rst:463 5fbf641413fb4f87b22ad3fdf182d156 +msgid "" +"This script lays out multiple copies of its own source code, into four " +"rectangles per page." +msgstr "このスクリプトは、自身のソースコードの複数のコピーを1ページあたり4つの四角形にレイアウトします。" + +#: ../../recipes-stories.rst:468 1c35f9b2175c47a18aca3868411ba209 +msgid "`docs/samples/story-write.py`" +msgstr "" + +#: ../../recipes-stories.rst:483 2d4629988ad647c49e83b0f07d176f1f +msgid "" +"How to do Iterative Layout for a Table of Contents with " +":meth:`Story.write_stabilized()`" +msgstr ":meth:`Story.write_stabilized()` を使用した目次付きの繰り返しレイアウトの方法" + +#: ../../recipes-stories.rst:485 5946282af74544c9bf1662d5f910b897 +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:488 ff3a95419d164d0dbea51a5adba61715 +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:492 4ef3dfdfc85b4f129ced1415701f5ff2 +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:498 8dee04f968454f14bbbd0409fe8765bf +msgid "`docs/samples/story-write-stabilized.py`" +msgstr "" + +#: ../../recipes-stories.rst:513 c45a0d71d3544496badba7ce2d147dce +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:515 86f298ccc39643f798304fc48f4e76e8 +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:519 dbc92943beae48c0a9494c053b436ad7 +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:522 a4f37a4de73d4dfeb0ee6c6fdb3c2394 +msgid "It does not take a :ref:`DocumentWriter` `writer` arg." +msgstr ":ref:`DocumentWriter` の `writer` 引数は必要ありません。" + +#: ../../recipes-stories.rst:523 0d78c07681f84661966c60c7c781466c +msgid "It returns a PDF :ref:`Document` instance." +msgstr "PDF :ref:`Document` のインスタンスを返します。" + +#: ../../recipes-stories.rst:525 0b1f40ee3efd474eb41e36260feb2131 +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:532 a0ccedea351747b3ad76611dc13a914d +msgid "`docs/samples/story-write-stabilized-links.py`" +msgstr "" + +#: ../../recipes-stories.rst:546 6ce3554cebac4c0c9c85dc3bad497682 +msgid "Footnotes" +msgstr "脚注" + +#: ../../recipes-stories.rst:547 f89deb8c8df0426496500f84df71e045 +msgid "HTML & CSS support" +msgstr "" + +#: ../../recipes-stories.rst:551 7ae2e6fefca54e27ab4a8716d76b99d5 +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:553 8a9ace71accc43a7a623f78219493f83 +msgid "Some important CSS support to consider:" +msgstr "考慮すべき重要なCSSサポート:" + +#: ../../recipes-stories.rst:555 cccde5c5c6284f41aef95610bd0d5008 +msgid "The only available layout is relative layout." +msgstr "唯一利用可能なレイアウトは相対レイアウトです。" + +#: ../../recipes-stories.rst:556 19e1a5f41aee4638b74988fca3d7f215 +msgid "`background` is unavailable, use `background-color` instead." +msgstr "`background` は利用できませんが、代わりに `background-color` を使用してください。" + +#: ../../recipes-stories.rst:557 227925182b5e49e9a96101103c4ab860 +msgid "`float` is unavailable." +msgstr "`float` は利用できません。" + +#: ../../footer.rst:-1 0e0709180bf64166ae3c61858af7e314 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/recipes-text.mo b/docs/locales/ja/LC_MESSAGES/recipes-text.mo new file mode 100644 index 000000000..d98ec974c Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/recipes-text.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/recipes-text.po b/docs/locales/ja/LC_MESSAGES/recipes-text.po new file mode 100644 index 000000000..525844baf --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/recipes-text.po @@ -0,0 +1,591 @@ +# 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" + +#: ../../recipes-text.rst:7 ccba9b00490a40749def6a90f99d21b7 +msgid "Text" +msgstr "テキスト" + +#: ../../recipes-text.rst:13 92d3caca432746adbebb0425746555ea +msgid "How to Extract all Document Text" +msgstr "すべてのドキュメントテキストを抽出する方法" + +#: ../../recipes-text.rst:15 96898f3ad785493f8d16133f6decf132 +msgid "" +"This script will take a document filename and generate a text file from " +"all of its text." +msgstr "このスクリプトは、ドキュメントのファイル名を受け取り、そのテキストからテキストファイルを生成します。" + +#: ../../recipes-text.rst:17 a0b04991b91c4c09af78f8db253f6bde +msgid "The document can be any :ref:`supported type`." +msgstr "ドキュメントは、:ref:`サポートされている ` 任意のタイプのものが使用できます。" + + +#: ../../recipes-text.rst:19 a758805c949b4dd8b60440b6ab488b4d +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 a7e85982f19b42a6a2fed821872037e9 +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 78525740a5c748a4b7d2607041ac7c46 +msgid "" +"You have many options to rectify this -- see chapter :ref:`Appendix2`. " +"Among them are:" +msgstr "これを修正するための多くのオプションがあります。詳細は :ref:`Appendix2` 章「埋め込みファイルに関する考慮事項」を参照してください。以下の方法があります：" + +#: ../../recipes-text.rst:32 e8227c94ea7244819016228f626a082c +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 72caec37d07e424e84d7e1763569e0fd +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 463839a1247b48a5994bbc432f06f14c +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 287edcdde76742dda51fa1ace34fae1e +msgid "See the following two sections for examples and further explanations." +msgstr "以下の2つのセクションを見て、例と詳細な説明をご覧ください。" + +#: ../../recipes-text.rst:46 ebd78068a8c64c1d82f4a82a1f4cb1e2 +msgid "How to Extract Key-Value Pairs from a Page" +msgstr "ページからキーと値のペアを抽出する方法" + +#: ../../recipes-text.rst:47 87d10670ed0c4639b6d1efc78282ad78 +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:49 b19a10c5c01249688dd16258f293178b +msgid "\"Predictable\" in this context means:" +msgstr "ここでの「予測可能」とは、次のような意味です：" + +#: ../../recipes-text.rst:51 965e29f7e9db4f3489f10ac62b06de6c +msgid "" +"Every keyword is followed by its value -- no other text is present in " +"between them." +msgstr "各キーワードの後にはその値が続きます。それらの間に他のテキストはありません。" + +#: ../../recipes-text.rst:52 68922bd9e0954760a9ea2d276d06e4b6 +msgid "" +"The bottom of the value's boundary box is **not above** the one of the " +"keyword." +msgstr "値の境界ボックスの下端は、キーワードの境界ボックスよりも上にありません。" + +#: ../../recipes-text.rst:53 8e09b95b440440ffbb43f86f7b847a42 +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:55 19a8815ffb6e40898c3bfde94a442ee0 +msgid "" +"For example, the following five key-value pairs will be correctly " +"identified::" +msgstr "例として、以下の5つのキーと値のペアが正しく識別されます::" + +#: ../../recipes-text.rst:71 911acae77fe04caaa3a2ec526e32681c +msgid "How to Extract Text from within a Rectangle" +msgstr "四角形内のテキストを抽出する方法" + +#: ../../recipes-text.rst:72 0c3a4146454448249d56313c805a9f17 +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:82 74e9b83226d247a49330dd00faba0405 +msgid "How to Extract Text in Natural Reading Order" +msgstr "自然な読み順でテキストを抽出する方法" + +#: ../../recipes-text.rst:84 ec8b767b373b4d8282cddedd092889c4 +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:86 6cfac5000f7d489c8a156689a00120f6 +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:98 ab65cf52fcb04e4984e528461b37673d +msgid "" +"The text sequence extracted from a page modified in this way will look " +"like this:" +msgstr "このように変更されたページから抽出されたテキストのシーケンスは次のようになります：" + +#: ../../recipes-text.rst:100 c74d0d98a1aa4e21ba73f207940f7f81 +msgid "original text" +msgstr "元のテキスト" + +#: ../../recipes-text.rst:101 f147992a91244ffc8b0f731bf13ea32d +msgid "header line" +msgstr "ヘッダーライン" + +#: ../../recipes-text.rst:102 58ccfd94582b4dfb8f4417a5a357659b +msgid "footer line" +msgstr "フッターライン" + +#: ../../recipes-text.rst:104 02bae1a3e9394a5aa7df7ba7b6c72bf7 +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:106 a99ac9750e614c7786ccc039c29827da +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:107 d5b22e2d0d5847acb4f1f3d0c229f53b +msgid "" +"Use the `fitz` module in CLI: `python -m fitz 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でfitzモジュールを使用します： `python -m fitz gettext ...` 。これにより、テキストがレイアウトを保持するモードで再配置されたテキストファイルが生成されます。出力を制御するための多くのオプションが利用可能です。" + +#: ../../recipes-text.rst:109 97e271fd1e8747cfbec85c86ea777dd0 +msgid "" +"You can also use the above mentioned `script " +"`_ with your modifications." +msgstr "また、上記の `スクリプト `_ を自分の変更とともに使用することもできます。" + + + +#: ../../recipes-text.rst:116 6b51fca0ea6c45888bc66baa1a3211af +msgid "" +"How to :index:`Extract Table Content ` from " +"Documents" +msgstr "ドキュメントから表の内容を抽出する方法" + + +#: ../../recipes-text.rst:117 50e680e96f014158b244450142148d5a +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:118 26977f00e992455697fb3433c23582c8 +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:119 +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:120 +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:121 62bd70f1643e4dcc9132ff52940da932 +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:128 97572fe388294c548c5710ee0733f825 +msgid "How to Mark Extracted Text" +msgstr "抽出したテキストをマークする方法" + +#: ../../recipes-text.rst:129 b46736ccf4bc46ec88a7700a35f1cad7 +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:131 081715bbdac745adac3c25cac8853ab9 +msgid "This method has advantages and drawbacks. Pros are:" +msgstr "この方法には利点と欠点があります。利点は次のとおりです：" + +#: ../../recipes-text.rst:133 ffb1405924a04ccbaad02db4afcc4e36 +msgid "The search string can contain blanks and wrap across lines" +msgstr "検索文字列には空白を含めることができ、行をまたぐことができます。" + +#: ../../recipes-text.rst:134 281a1b31d1d143fe80bd095fc3abdebc +msgid "Upper or lower case characters are treated equal" +msgstr "大文字と小文字は同じように扱われます。" + +#: ../../recipes-text.rst:135 c29759846f694fcd97e4f30c502448e6 +msgid "Word hyphenation at line ends is detected and resolved" +msgstr "行末での単語のハイフネーションが検出され、解決されます。" + +#: ../../recipes-text.rst:136 a2a9b93bca9b4aaba1ac42d0c1d86cd9 +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:138 b348f2fac3974cf686f04c1653758618 +msgid "But you also have other options::" +msgstr "ただし、他にも選択肢があります::" + +#: ../../recipes-text.rst:172 052d84a1f0474c4298a9789d2d0bc24a +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 spaces and line breaks as delimiters. Further remarks:" +msgstr "このスクリプトは、cliパラメーターを介して渡された文字列を検索するためにPage.get_text("words")を使用します。この方法では、ページのテキストがスペースと改行を区切りとして「単語」に分割されます。さらなる注釈：" + +#: ../../recipes-text.rst:174 3e22cd751bc34e12900c433633756364 +msgid "" +"If found, the **complete word containing the string** is marked " +"(underlined) -- not only the search string." +msgstr "文字列が見つかった場合、検索文字列だけでなく、その文字列を含む完全な単語がマークされます（アンダーラインが引かれます）。" + +#: ../../recipes-text.rst:175 461f808619f24355ba72e89a7a06a56d +msgid "The search string may **not contain spaces** or other white space." +msgstr "検索文字列にはスペースや他の空白文字を含めることはできません。" + +#: ../../recipes-text.rst:176 e620d3a1f08b4dd197fd333abff27c95 +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:177 6b38c42ef5d64a27ae49e6cceae9c5c8 +msgid "There is **no upper limit**: all occurrences will be detected." +msgstr "上限はありません。すべての出現を検出します。" + +#: ../../recipes-text.rst:178 ff1b210cef9e4c3aa3c30d69756b5b90 +msgid "" +"You can use **anything** to mark the word: 'Underline', 'Highlight', " +"'StrikeThrough' or 'Square' annotations, etc." +msgstr "単語をマークするために何を使用しても構いません：「アンダーライン」、「ハイライト」、「取り消し線」、「四角」の注釈などがあります。" + +#: ../../recipes-text.rst:179 00762b6ebf684ed3904bf84298161781 +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:190 2f5366579c7e4411a85585716f2a961d +msgid "How to Mark Searched Text" +msgstr "検索したテキストをマークする方法" + +#: ../../recipes-text.rst:191 1e301915cc8d4a51afda8d0934efada8 +msgid "This script searches for text and marks it::" +msgstr "このスクリプトはテキストを検索してマークします::" + +#: ../../recipes-text.rst:215 407b4d50e2eb4de89f24ec4806e57cbc +msgid "The result looks like this:" +msgstr "結果は以下のようになります：" + +#: ../../recipes-text.rst:226 591e5124e8104eccb15238268db3a1df +msgid "How to Mark Non-horizontal Text" +msgstr "非水平テキストをマークする方法" + +#: ../../recipes-text.rst:227 eca0b2caaca84effb74ec9ba918e79ff +msgid "" +"The previous section already shows an example for marking non-horizontal " +"text, that was detected by text **searching**." +msgstr "前のセクションでは、テキスト検索によって検出された非水平テキストのマークの例が既に示されています。" + +#: ../../recipes-text.rst:229 b302c43142e14145a8f17bacb8dfbb45 +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:231 28f3e2246ad74457b3e1dfce41cf3b09 +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:236 0609c59dd42b418ba69740a586511529 +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:243 4e73feba9fd34be88924055d93141f6b +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:250 36bad0cac48d42e6ac3ec4cf31217ba8 +msgid "How to Analyze Font Characteristics" +msgstr "フォントの特性を分析する方法" + +#: ../../recipes-text.rst:251 427f665b23b64e708fc10a044bb1827e +msgid "" +"To analyze the characteristics of text in a PDF use this elementary " +"script as a starting point:" +msgstr "PDF内のテキストの特性を分析するには、以下の初歩的なスクリプトを出発点として使用します::" + +#: ../../recipes-text.rst:256 f70238e7fe75454c9441248bb16b131c +msgid "Here is the PDF page and the script output:" +msgstr "以下はPDFページとスクリプトの出力です。" + +#: ../../recipes-text.rst:267 97733030380048b0b9348cdaf7b77d17 +msgid "How to Insert Text" +msgstr "テキストの挿入方法" + +#: ../../recipes-text.rst:268 22e5f384661740d8be9f13e27aef47a7 +msgid "" +"PyMuPDF provides ways to insert text on new or existing PDF pages with " +"the following features:" +msgstr "PyMuPDFは、以下の機能を備えて新しいまたは既存のPDFページにテキストを挿入する方法を提供しています：" + +#: ../../recipes-text.rst:270 b278661ebcc546fbb61b5a4aee7264d0 +msgid "" +"choose the font, including built-in fonts and fonts that are available as" +" files" +msgstr "フォントの選択：組み込みのフォントやファイルとして利用可能なフォントを選択できます。" + +#: ../../recipes-text.rst:271 023ff4d3e8be44a48f4cba8662bf463d +msgid "choose text characteristics like bold, italic, font size, font color, etc." +msgstr "テキストの特性の選択：太字、斜体、フォントサイズ、フォントカラーなど、テキストの特性を選択できます。" + +#: ../../recipes-text.rst:272 3025abe4be4e4993a796567f720cd129 +msgid "position the text in multiple ways:" +msgstr "テキストの配置方法：" + +#: ../../recipes-text.rst:274 efff4277d3844acd850efe7a43679540 +msgid "either as simple line-oriented output starting at a certain point," +msgstr "特定のポイントを起点として単純な行指向の出力として配置することができます。 " + +#: ../../recipes-text.rst:275 311c20c8bc4d47c3ab4144810c8d3046 +msgid "" +"or fitting text in a box provided as a rectangle, in which case text " +"alignment choices are also available," +msgstr "ボックスにテキストをフィットさせる場合は、テキストの配置を選択することもできます。この場合、テキストの整列オプションも利用できます。" + +#: ../../recipes-text.rst:276 0850244aec3c42a8892f1a33dfbc79ca +msgid "" +"choose whether text should be put in foreground (overlay existing " +"content)," +msgstr "テキストを前面に配置するか選択できます（既存のコンテンツをオーバーレイします）。" + +#: ../../recipes-text.rst:277 e0d5ddb47f7a4d739d7f144dfa300a63 +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:278 031e878ab9824c51a8d871294912bf1c +msgid "" +"independently from morphing and in addition to that, text can be rotated " +"by integer multiples of 90 degrees." +msgstr "変形とは別に、テキストを90度の整数倍で回転させることもできます。" + +#: ../../recipes-text.rst:280 5616ea9fe55f4b3cb5740944960803d8 +msgid "" +"All of the above is provided by three basic :ref:`Page`, resp. " +":ref:`Shape` methods:" +msgstr "以上のすべては、それぞれの基本的な :ref:`Page` 、:ref:`Shape` メソッドによって提供されています。" + +#: ../../recipes-text.rst:282 8fae2b164af645ec89191dcd922bbb8d +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:284 7a6fc5cb3b864bb89afc36da42238bc9 +msgid "provided as a file," +msgstr "ファイルとして提供する。" + +#: ../../recipes-text.rst:285 bb2eb5e2e0794d419c134c2c8e26f67c +msgid "via :ref:`Font` (then use :attr:`Font.buffer`)" +msgstr ":ref:`Font` を使用して提供する（その場合、 :attr:`Font.buffer` を使用します）。" + +#: ../../recipes-text.rst:286 b8130e1d9b1d4498b9ecb44586ee2532 +msgid "already present somewhere in **this or another** PDF, or" +msgstr "既にこのPDFまたは別のPDFのどこかに存在する。" + +#: ../../recipes-text.rst:287 1d328ad6cd25477db4db1095f2fa9f1b +msgid "be a **built-in** font." +msgstr "組み込みフォントである。" + +#: ../../recipes-text.rst:289 b9ea076b16a44507bc61e0d25fcb6fd0 +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:291 b2b0a49add964650a21e1e19f12258d1 +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:293 1bac1e80f5724fd79112ad252522ef26 +msgid "Both text insertion methods automatically install the font as necessary." +msgstr "テキスト挿入の両方の方法は、必要に応じてフォントを自動的にインストールします。" + +#: ../../recipes-text.rst:299 888c2a23ad5f40e3900ae1a97487af46 +msgid "How to Write Text Lines" +msgstr "テキスト行を書く方法" + +#: ../../recipes-text.rst:300 20121bbda5864d02a875b561e948047c +msgid "Output some text lines on a page::" +msgstr "ページにいくつかのテキスト行を出力する方法::" + +#: ../../recipes-text.rst:321 2b01a228a66343a3a3c4c342e7546772 +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 fontsize and 36 points (0.5 inches) as bottom margin." +msgstr "この方法では、ページの高さを超えないように行の数だけを制御します。余剰の行は書き込まれず、実際の行数が返されます。計算には、フォントサイズと36ポイント（0.5インチ）のボトムマージンから計算された行の高さが使用されます。" + +#: ../../recipes-text.rst:323 2f28d5533ac74ef0850ea1dd3b08ccd3 +msgid "" +"Line **width is ignored**. The surplus part of a line will simply be " +"invisible." +msgstr "行の幅は無視されます。行の余剰部分は単に見えなくなります。" + +#: ../../recipes-text.rst:325 ebc7a919fc59414f8110876bfaf79f48 +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:327 d11d3d51671047f88118bb40ed2e2350 +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:363 954b053dc37d4a008fc125fa59d8ba07 +msgid "This is the result:" +msgstr "これが結果です。" + +#: ../../recipes-text.rst:375 cd66e9ddab544c4dbe3260c3813cf154 +msgid "How to Fill a Text Box" +msgstr "テキストボックスの塗りつぶし方" + +#: ../../recipes-text.rst:376 3eb798395fb448eab5381ad6df3c0997 +msgid "" +"This script fills 4 different rectangles with text, each time choosing a " +"different rotation value::" +msgstr "このスクリプトは、異なる回転値を選択して、4つの異なる長方形にテキストを塗りつぶします。" + +#: ../../recipes-text.rst:411 012663f882c24e31b16db6846afa605d +msgid "" +"Several default values were used above: font \"Helvetica\", font size 11 " +"and text alignment \"left\". The result will look like this:" +msgstr "上記ではいくつかのデフォルト値が使用されました：フォント「Helvetica」、フォントサイズ11、テキストの配置は「左寄せ」です。結果は以下のようになります。" + +#: ../../recipes-text.rst:421 d753e470c8984f12aa1fc6eef65dddad +msgid "How to Use Non-Standard Encoding" +msgstr "非標準エンコーディングの使用方法" + +#: ../../recipes-text.rst:422 56d9253be1f94c2eb5e9c780964d2fe6 +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でロシア語のエンコーディングを要求する方法です::" + +#: ../../recipes-text.rst:426 3cf9ef54c11744a2a6d6085322ba40a6 +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です。エンコーディングは、すべての関連するフォントおよびテキスト挿入メソッドで指定できます。" + +#: ../../recipes-text.rst:428 6f58b6fb787d4d36bdc494fd31080531 +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エンコーディングが使用されます。" + +#: ../../recipes-text.rst:430 ee10bde828244f059542bb0bba14f033 +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 "フォント名をわずかに変更することで、同じベースフォントの同じページ上でエンコーディングの「混合」を実現することもできます。" + +#: ../../recipes-text.rst:443 658699a00d464dc8a49d2230baed46de +msgid "The result:" +msgstr "結果は以下の通りです。" + +#: ../../recipes-text.rst:448 4ed767d8bf124542baba0fa0997e55ca +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"）を使用して一意に識別され、参照が可能です。" + +#: ../../footer.rst:-1 9b1c21603b2841a891af9678a37fb360 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/recipes.mo b/docs/locales/ja/LC_MESSAGES/recipes.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/recipes.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/recipes.po b/docs/locales/ja/LC_MESSAGES/recipes.po new file mode 100644 index 000000000..46ff0a928 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/recipes.po @@ -0,0 +1,25 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../footer.rst:-1 b932cdbbb11e4cb7826dbc223b8ba6bb +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/rect.mo b/docs/locales/ja/LC_MESSAGES/rect.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/rect.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/rect.po b/docs/locales/ja/LC_MESSAGES/rect.po new file mode 100644 index 000000000..b00eeb398 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/rect.po @@ -0,0 +1,769 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../rect.rst:7 a6bfc3a7d769457490fcc64cc87d742f +msgid "Rect" +msgstr "" + +#: ../../rect.rst:9 2bf54a3eaddb48c48fde0129a4560faa +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.rst:11 08b5de166b25450b83a4ddd2988c75d3 +msgid "The following remarks are also valid for :ref:`IRect` objects:" +msgstr "" + +#: ../../rect.rst:13 cd70b9379c744653b0df2693ccb0fee9 +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 "" + +#: ../../rect.rst:14 8fdced3de2434f2bb16e3f595c0c76c5 +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 40bc58e57a214b3d940e6e90926b63be +msgid "Units are in points, where 72 points is 1 inch." +msgstr "" + +#: ../../rect.rst:20 b8f105c299714ca9b564f51f982de7db +msgid "" +"For any given quadruple of numbers, the geometrically \"same\" rectangle " +"can be defined in four different ways:" +msgstr "" + +#: ../../rect.rst:17 c8b434bf95b248f39d10b9877015cc6e +msgid "Rect(P\\ :sub:`(x0,y0)`, P\\ :sub:`(x1,y1)`\\ )" +msgstr "" + +#: ../../rect.rst:18 0d02a7dd8fbc4f998f673456e975d3b8 +msgid "Rect(P\\ :sub:`(x1,y1)`, P\\ :sub:`(x0,y0)`\\ )" +msgstr "" + +#: ../../rect.rst:19 6fa1b6597e174cfb8fb291ce55fa0717 +msgid "Rect(P\\ :sub:`(x0,y1)`, P\\ :sub:`(x1,y0)`\\ )" +msgstr "" + +#: ../../rect.rst:20 6f445ff7b4d74c7cac0dd617f6f32888 +msgid "Rect(P\\ :sub:`(x1,y0)`, P\\ :sub:`(x0,y1)`\\ )" +msgstr "" + +#: ../../rect.rst:22 1c1eb036cc89469e8d2a1eebe14fd4ab +msgid "**(Changed in v1.19.0)** Hence some classification:" +msgstr "" + +#: ../../rect.rst:24 2c05baa6d2c2407cbc43b1fb06a50a33 +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 "" + +#: ../../rect.rst:26 f85897a8bfec45e995ed721a8dce867d +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 "" + +#: ../../rect.rst:28 9fffb102deb84b4d93da3ab6b4ec8a63 +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 "" + +#: ../../rect.rst:30 01da167f72da4a71ba41b86f927fa35b +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 "" + +#: ../../rect.rst:32 b7e59893f3e743038fb387f91db59882 +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 "" + +#: ../../rect.rst:38 84fb3d40f3b44591bb2c70654a3efe68 +msgid "Here is an overview of the changes." +msgstr "" + +#: ../../rect.rst:41 d7a02c85e287459bb08565b1f2245334 +msgid "Notion" +msgstr "" + +#: ../../rect.rst:41 2b5a9d4dad0f404e8891e060c203ae8d +msgid "Versions < 1.19.0" +msgstr "" + +#: ../../rect.rst:41 ef2e344cf9944e26816ba1da781aade1 +msgid "Versions 1.19.*" +msgstr "" + +#: ../../rect.rst:43 e4f0b001864f46e69b560e2751ba49f2 +msgid "empty" +msgstr "" + +#: ../../rect.rst:43 70ebc657cae245a0ae745c79cd655ed9 +msgid "x0 = x1 or y0 = y1" +msgstr "" + +#: ../../rect.rst:43 94aa8aa78f474c449a29e87c0e43af0a +msgid "x0 >= x1 or y0 >= y1 -- includes invalid rects" +msgstr "" + +#: ../../rect.rst:44 91cab8254f2b4ad19a6f402771cee026 +msgid "valid" +msgstr "" + +#: ../../rect.rst:44 ff0cbe478e8b498dabc8c5dad979fde4 +msgid "n/a" +msgstr "" + +#: ../../rect.rst:44 2a637bc6bf7a4beb89c07401da5abd39 +msgid "x0 <= x1 and y0 <= y1" +msgstr "" + +#: ../../rect.rst:45 9f2d52ec216543e1aa4e604dcaa2f458 +msgid "infinite" +msgstr "" + +#: ../../rect.rst:45 61705ea9e68c4a3da721cb8a175f206f +msgid "all rects where x0 > x1 or y1 > y0" +msgstr "" + +#: ../../rect.rst:45 48804664e73a426ab14bbe895e6720af +msgid "**exactly one infinite rect / irect!**" +msgstr "" + +#: ../../rect.rst:46 5cb8309f04dd4135aef45febdca322a9 +msgid "coordinate values" +msgstr "" + +#: ../../rect.rst:46 d9c43480e29f4ed3b05900c16bf00fb2 +msgid "all numbers" +msgstr "" + +#: ../../rect.rst:46 35033e0d730a4dbfb43e439df99d5682 +msgid "`FZ_MIN_INF_RECT <= number <= FZ_MAX_INF_RECT`" +msgstr "" + +#: ../../rect.rst:47 0fe04c8e972740288efa756d5bb7a284 +msgid "borders, corners" +msgstr "" + +#: ../../rect.rst:47 134cefd850994f95a02d4338accda2e2 +msgid "are parts of the rectangle" +msgstr "" + +#: ../../rect.rst:47 2b9a74e9072d44c79e5915ae1a9d2e14 +msgid "right and bottom corners and edges **are outside**" +msgstr "" + +#: ../../rect.rst:50 198f46dfc65f4a9a9d54b9cbfd1834a5 +msgid "" +"There are new top level functions defining infinite and standard empty " +"rectangles and quads, see :meth:`INFINITE_RECT` and friends." +msgstr "" + +#: ../../rect.rst:54 fba1488472f34d16922f0b9d02ca7adc +msgid "**Methods / Attributes**" +msgstr "" + +#: ../../rect.rst:54 fc214a75cf834f79a0c84b154c90e83a +msgid "**Short Description**" +msgstr "" + +#: ../../rect.rst:56 4e4795444c6d4f8da6219eade8eb9f26 +msgid ":meth:`Rect.contains`" +msgstr "" + +#: ../../rect.rst:56 9310df9e972f4411bd2a28f2dbbc0f52 +msgid "checks containment of point_likes and rect_likes" +msgstr "" + +#: ../../rect.rst:57 4264e1ec8c024e07a9309c800d9938f2 +msgid ":meth:`Rect.get_area`" +msgstr "" + +#: ../../rect.rst:57 c99e1f4a802745ffaa443429849680f7 +msgid "calculate rectangle area" +msgstr "" + +#: ../../rect.rst:58 bac88765720f42a98c407d4a45f7bb0b +msgid ":meth:`Rect.include_point`" +msgstr "" + +#: ../../rect.rst:58 59f7d53f4a38489b88179a4931979bde +msgid "enlarge rectangle to also contain a point" +msgstr "" + +#: ../../rect.rst:59 2e86f25e849b467d93b6f012e41766ca +msgid ":meth:`Rect.include_rect`" +msgstr "" + +#: ../../rect.rst:59 e684d817f262437e96cf079e40fc066a +msgid "enlarge rectangle to also contain another one" +msgstr "" + +#: ../../rect.rst:60 772f0e583ba14dfdac051bf42c7b6edd +msgid ":meth:`Rect.intersect`" +msgstr "" + +#: ../../rect.rst:60 b53875a2fbc9482c88a8271dfab29c26 +msgid "common part with another rectangle" +msgstr "" + +#: ../../rect.rst:61 4b92aa07395f4e429920c4bfe6970a08 +msgid ":meth:`Rect.intersects`" +msgstr "" + +#: ../../rect.rst:61 e395d962cca44f36a7cedcd7130e2581 +msgid "checks for non-empty intersections" +msgstr "" + +#: ../../rect.rst:62 f61ed4b5858b4536b5429abc360dbaaa +msgid ":meth:`Rect.morph`" +msgstr "" + +#: ../../rect.rst:62 e258e88ddde04cdc9647fbc13fa61c9a +msgid "transform with a point and a matrix" +msgstr "" + +#: ../../rect.rst:63 a18e8e69222246a180646c827f6282a7 +msgid ":meth:`Rect.torect`" +msgstr "" + +#: ../../rect.rst:63 862ef1efc2d746f1b8a86b9b52e9fd80 +msgid "the matrix that transforms to another rectangle" +msgstr "" + +#: ../../rect.rst:64 3d5cb0fa80d04905a558aa9177552481 +msgid ":meth:`Rect.norm`" +msgstr "" + +#: ../../rect.rst:64 4aa5ef4653944472a68baf2a9e1c1bc6 +msgid "the Euclidean norm" +msgstr "" + +#: ../../rect.rst:65 8f23d88142b74442b8be8b8b6f5463ca +msgid ":meth:`Rect.normalize`" +msgstr "" + +#: ../../rect.rst:65 8f0567d4de8d4e76aa353b0a27b10b89 +msgid "makes a rectangle valid" +msgstr "" + +#: ../../rect.rst:66 ff81e82e91804ed2af113682d14fb6bc +msgid ":meth:`Rect.round`" +msgstr "" + +#: ../../rect.rst:66 bfb70e0266ba4229b3f038dadc3a8281 +msgid "create smallest :ref:`Irect` containing rectangle" +msgstr "" + +#: ../../rect.rst:67 596b4d682a6849189e86a5e7b94dbc25 +msgid ":meth:`Rect.transform`" +msgstr "" + +#: ../../rect.rst:67 31ddc27eee674943890ca6ab3eb10ce8 +msgid "transform rectangle with a matrix" +msgstr "" + +#: ../../rect.rst:68 e3de2f26ffe4453ea81f879bc4214dc7 +msgid ":attr:`Rect.bottom_left`" +msgstr "" + +#: ../../rect.rst:68 1f4b7d9633e9404cb5f7c5656f1e65a6 +msgid "bottom left point, synonym *bl*" +msgstr "" + +#: ../../rect.rst:69 9639552ea21b42349ae55142265b9e46 +msgid ":attr:`Rect.bottom_right`" +msgstr "" + +#: ../../rect.rst:69 f1e36ec13e474626803dabfdf248126b +msgid "bottom right point, synonym *br*" +msgstr "" + +#: ../../rect.rst:70 8c5b07da82004d80893807e98a1e78af +msgid ":attr:`Rect.height`" +msgstr "" + +#: ../../rect.rst:70 8da4a65f25f64c5588bd1c8667c52495 +msgid "rectangle height" +msgstr "" + +#: ../../rect.rst:71 e2d0db3a3c4f47d5b293ee8f347dca30 +msgid ":attr:`Rect.irect`" +msgstr "" + +#: ../../rect.rst:71 9e2ad7b281af4c6081667f25149dbdea +msgid "equals result of method *round()*" +msgstr "" + +#: ../../rect.rst:72 e389a13325be43e587a9c83a0fa76a6d +msgid ":attr:`Rect.is_empty`" +msgstr "" + +#: ../../rect.rst:72 a546059efdcb456b9a336f451b47f20b +msgid "whether rectangle is empty" +msgstr "" + +#: ../../rect.rst:73 d9c5f4849a71494592ba2090948cd485 +msgid ":attr:`Rect.is_valid`" +msgstr "" + +#: ../../rect.rst:73 627c40388b944ca3bd15c0ebc93c4dea +msgid "whether rectangle is valid" +msgstr "" + +#: ../../rect.rst:74 b59be4a81b1e441eae2566a2fb759a15 +msgid ":attr:`Rect.is_infinite`" +msgstr "" + +#: ../../rect.rst:74 3de9073d33494914a346443be2662c3f +msgid "whether rectangle is infinite" +msgstr "" + +#: ../../rect.rst:75 d08f7391f9794de289896f99ff383fd1 +msgid ":attr:`Rect.top_left`" +msgstr "" + +#: ../../rect.rst:75 d162f808277447138a5cd00d91e78e19 +msgid "top left point, synonym *tl*" +msgstr "" + +#: ../../rect.rst:76 ce65ad0de34b482da10bb737cbe29bdf +msgid ":attr:`Rect.top_right`" +msgstr "" + +#: ../../rect.rst:76 8740936879124a37b5031461cb23ff78 +msgid "top_right point, synonym *tr*" +msgstr "" + +#: ../../rect.rst:77 2c2fd855340a404ab5c36797cdb691b1 +msgid ":attr:`Rect.quad`" +msgstr "" + +#: ../../rect.rst:77 ba0d6080d88644c7a65faf1f837e5b10 +msgid ":ref:`Quad` made from rectangle corners" +msgstr "" + +#: ../../rect.rst:78 23079b32d70d4fd88b55df7e15018b38 +msgid ":attr:`Rect.width`" +msgstr "" + +#: ../../rect.rst:78 461fc65f55984b36939ab4c5a86a98ee +msgid "rectangle width" +msgstr "" + +#: ../../rect.rst:79 bd649630ff624d6ea9650773d08d1848 +msgid ":attr:`Rect.x0`" +msgstr "" + +#: ../../rect.rst:79 1a4f98006ad240a28380b1a39abe0478 +msgid "left corners' x coordinate" +msgstr "" + +#: ../../rect.rst:80 c86b2065abce45a3961021378286b474 +msgid ":attr:`Rect.x1`" +msgstr "" + +#: ../../rect.rst:80 132dc2306b4e4c74bedc93f05fa04209 +msgid "right corners' x -coordinate" +msgstr "" + +#: ../../rect.rst:81 6316f8989a0b40d395b902362d0b2029 +msgid ":attr:`Rect.y0`" +msgstr "" + +#: ../../rect.rst:81 e77f16812c5141e8a01f67debe14cad8 +msgid "top corners' y coordinate" +msgstr "" + +#: ../../rect.rst:82 5cc16cdbde2449c0a0524e77d686ba28 +msgid ":attr:`Rect.y1`" +msgstr "" + +#: ../../rect.rst:82 46f47f56c3e24e89888827055a5dcb1e +msgid "bottom corners' y coordinate" +msgstr "" + +#: ../../rect.rst:85 f447b20159da4cce8cde4b26dfc41e24 +msgid "**Class API**" +msgstr "" + +#: ../../rect.rst:103 0208035eec614289aff92d0e44ed400b +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 "" + +#: ../../rect.rst:105 2a5d4c6744ba4230a73a642f6e125d09 +msgid "If \"rect\" is specified, the constructor creates a **new copy** of it." +msgstr "" + +#: ../../rect.rst:107 f7e848d2a88d42449d4d8b85a877c946 +msgid "" +"Without parameters, the empty rectangle *Rect(0.0, 0.0, 0.0, 0.0)* is " +"created." +msgstr "" + +#: ../../rect.rst:111 5a16d61e49a44d788fc119925173877c +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 "" + +#: ../../rect.rst:116 87062d1d63e94b5cb5fe0970d257a1dd +msgid "If the rectangle is **empty**, the result is also empty." +msgstr "" + +#: ../../rect.rst:117 85b397496fd844a38e5d78988c8f04bb +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 "" + +#: ../../rect.rst 04ba20fd7bd84456b048e5bc6dbd8c88 +#: 38ca672d557948eab31a0558062afe5a 5c534a5e197342d8988eda952e0a87b3 +#: 67960b2de4a441f1b05b1f4e1d899b92 6cb2074ff7ab49f7ad4eec4d7eb5bca6 +#: 7ae4c8a082694778962e298488e7a61a d8d3fb31943b402ca8b052ace1bc96fc +#: f61c29593601478ab4220c39ae16369c +msgid "Return type" +msgstr "" + +#: ../../rect.rst:127 2bc9ac627c8e499e8f2562a73ad399a6 +msgid ":ref:`IRect`" +msgstr "" + +#: ../../rect.rst:131 9cc449ac87134736a6617341e5eceb3b +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 22f08a1255c74745b612cc9f244abe7d +#: 5afa711ce5154321b8a81ea00411a09f 844e0b083f3146f2b01e0f44e6ce63cf +#: aa7b3db959f24c08a83a6ee32a6cf6f9 bc3289a46f924a51881ec2ce37ee15a3 +#: caa4f76c56b449ce8e345e02a719a6e7 e1a3d685b86047b483096bc7b2d31037 +#: e7e3a66bf07940708708df358cc5599d fad35629cb404637b3acd85237b87275 +msgid "Parameters" +msgstr "" + +#: ../../rect.rst:133 30ba2fbbff7541d385299ab11ec82851 +msgid "The matrix for the transformation." +msgstr "" + +#: ../../rect.rst:136 45298adb2a1947c2b2a869cc12151e6b +msgid "*Rect*" +msgstr "" + +#: ../../rect.rst 331feb35605a44baa98dcc2481ad7796 +#: 3d348de5d63947d182080961e5c25808 491cb3c77e7d466e9a7a7ff08ca8ea3b +msgid "Returns" +msgstr "" + +#: ../../rect.rst:137 7c9abda61a9746e385b85a16305077ba +msgid "the smallest rectangle that contains the transformed original." +msgstr "" + +#: ../../rect.rst:141 9971ef22d2784e7990117c342438c003 +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 "" + +#: ../../rect.rst:143 ../../rect.rst:150 6721df1793cd45e2a1f59ff54750303a +#: e6f1752521da48ea8bba39dc1a06897a +msgid "Second rectangle" +msgstr "" + +#: ../../rect.rst:148 28c0cc29b21145088878d3fabac7527d +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 "" + +#: ../../rect.rst:155 ce0c9aac25174647a991e9964a2b1a06 +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) *fitz.Rect(p1, p1)* and successively include the " +"remaining points." +msgstr "" + +#: ../../rect.rst:157 6c8e7f23e2274b79ba95107fcf9fbd6b +msgid "Point to include." +msgstr "" + +#: ../../rect.rst:163 82abe45ba4d94212a66b71227396d56a +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 *fitz.Rect(p1, p2)* and *fitz.Rect(p2, " +"p1)* has a zero area." +msgstr "" + +#: ../../rect.rst:165 4badb6f651f54a2482d3ccafa65ad6fc +msgid "" +"Specify required unit: respective squares of *px* (pixels, default), *in*" +" (inches), *cm* (centimeters), or *mm* (millimeters)." +msgstr "" + +#: ../../rect.rst:170 49846b7cb9fa42939e5e268ced119d80 +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 "" + +#: ../../rect.rst:172 09c2e7293c5249d484d222972cb07611 +msgid "the object to check." +msgstr "" + +#: ../../rect.rst:179 b38594bd05f04400b095e5112a5fa8b0 +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 "" + +#: ../../rect.rst:181 3548014a290140e79dda25ebb4a08b20 +msgid "the rectangle to check." +msgstr "" + +#: ../../rect.rst:187 13a699c4049a48fb99438447b4e0a6e0 +msgid "New in version 1.19.3" +msgstr "" + +#: ../../rect.rst:189 9279805914734b3db81c5500fe785151 +msgid "Compute the matrix which transforms this rectangle to a given one." +msgstr "" + +#: ../../rect.rst:191 2aca556ebdf74db08e07d19e79c4cdf1 +msgid "the target rectangle. Must not be empty or infinite." +msgstr "" + +#: ../../rect.rst:192 c08055e10fc74a9aba960a251f648e60 +msgid ":ref:`Matrix`" +msgstr "" + +#: ../../rect.rst:193 635a2bafc5cd425dbd818b80ddb7b78a +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 "" + +#: ../../rect.rst:197 667d223fb02544ccb8105e97bbae363f +msgid "New in version 1.17.0" +msgstr "" + +#: ../../rect.rst:199 46118e9afea24be3a991a76da5043c66 +msgid "" +"Return a new quad after applying a matrix to the rectangle using the " +"fixed point `fixpoint`." +msgstr "" + +#: ../../rect.rst:201 31789d0aba0445ae80d823d762b70ae4 +msgid "the fixed point." +msgstr "" + +#: ../../rect.rst:202 050514a86ea44267b22e328fc9dc6a5b +msgid "the matrix." +msgstr "" + +#: ../../rect.rst:203 580db7617e684fac9766de14dd54ad5d +msgid "" +"a new :ref:`Quad`. This a wrapper for the same-named quad method. If " +"infinite, the infinite quad is returned." +msgstr "" + +#: ../../rect.rst:207 f9d6629fa0044445a775a85c52c4d000 +msgid "New in version 1.16.0" +msgstr "" + +#: ../../rect.rst:209 c4ef7cdb87de469d920aaabbb40d9ade +msgid "" +"Return the Euclidean norm of the rectangle treated as a vector of four " +"numbers." +msgstr "" + +#: ../../rect.rst:213 9f4045a34e52402ea9a3b02bad8f037c +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 98cae8611d7c4ae2b4f75f7fe86538b0 +msgid "Equals result of method *round()*." +msgstr "" + +#: ../../rect.rst:223 485f87fd57784f6b8f8705d009c7347f +msgid "Equals *Point(x0, y0)*." +msgstr "" + +#: ../../rect.rst 0acc6fafb1884ca8a45a81e08e0bd9bc +#: 1681a6d16bc54a1da622f8bea48bfbc6 258364137eee4c20ae70d472fa865f59 +#: 36665c32e3fd41b5be17eef2b9f9ef49 54367d138e1a449d91bfc175867fa551 +#: 5467055f78f744889474c9f72b6c16dd a00d3f5611c144efbfc34996565b9123 +#: a1db20ec81a54a60b1a06ab814ffb71a d17d8529bd404fcf9b6d1a54470a1fed +#: d4573da85f984e09883a00fc6a9189fc d473ff59b3aa47898f1321b3fff40d60 +#: e6714ed240964fb3bbee06f222a8b4e5 +msgid "type" +msgstr "" + +#: ../../rect.rst:225 ../../rect.rst:233 ../../rect.rst:241 ../../rect.rst:249 +#: 4ace9368bcd643079c6aa403c8c4b44b 552bd679f2354f4a8a0fa023d3864f07 +#: b2ba03f9e73e48708b72dd76b03ea7a4 e77e0ad121dd410dbf01799ed2a79e8a +msgid ":ref:`Point`" +msgstr "" + +#: ../../rect.rst:231 ecb74eebad8d40b19f9202b7cae07e75 +msgid "Equals `Point(x1, y0)`." +msgstr "" + +#: ../../rect.rst:239 5df0f9d1c6ce45c8aa73940fb350367c +msgid "Equals `Point(x0, y1)`." +msgstr "" + +#: ../../rect.rst:247 bb66227bf5c04e9c90e8ea673d93bbef +msgid "Equals `Point(x1, y1)`." +msgstr "" + +#: ../../rect.rst:253 40b4025dac314e6b8886550dd3dcfa09 +msgid "The quadrilateral `Quad(rect.tl, rect.tr, rect.bl, rect.br)`." +msgstr "" + +#: ../../rect.rst:255 5d52fd74746c42ea9d18b9a576403d9e +msgid ":ref:`Quad`" +msgstr "" + +#: ../../rect.rst:259 b1ab0d96b1ec497b8dac59fe3dbea7b8 +msgid "Width of the rectangle. Equals `max(x1 - x0, 0)`." +msgstr "" + +#: ../../rect.rst:265 0bed86dec83d4fafb151956599df9bcd +msgid "Height of the rectangle. Equals `max(y1 - y0, 0)`." +msgstr "" + +#: ../../rect.rst:271 cd909cbe39394eba8b7fadfeff94c9bf +msgid "X-coordinate of the left corners." +msgstr "" + +#: ../../rect.rst:273 ../../rect.rst:279 ../../rect.rst:285 ../../rect.rst:291 +#: 32866a060aa84014859971026c23137d 8170a7bd525b4515a2b99e6d692e5380 +#: a2410b728db84dea8d62ee09fff477cd cdeae62d8f584af7960f0ea22ab99a59 +msgid "float" +msgstr "" + +#: ../../rect.rst:277 8c41ef4bb3954af697a5188b82c54625 +msgid "Y-coordinate of the top corners." +msgstr "" + +#: ../../rect.rst:283 0844d78e011a44fb9bad81f4211e9886 +msgid "X-coordinate of the right corners." +msgstr "" + +#: ../../rect.rst:289 86f477476904432c949313f1acbe6f7f +msgid "Y-coordinate of the bottom corners." +msgstr "" + +#: ../../rect.rst:295 366c33753f304906b7a328d76102191f +msgid "`True` if this is the infinite rectangle." +msgstr "" + +#: ../../rect.rst:297 ../../rect.rst:303 ../../rect.rst:309 +#: 030b6959c49c469e98e3d0c554253b45 1ff66158bf134cc1bb07fff8df3c6f8f +#: e6fce7ec463c4d2e9992ebed76f5ed1e +msgid "bool" +msgstr "" + +#: ../../rect.rst:301 4f3c10464ec64684883dff31f974ccd8 +msgid "`True` if rectangle is empty." +msgstr "" + +#: ../../rect.rst:307 a98a763c003941519d09e2d015a2e614 +msgid "`True` if rectangle is valid." +msgstr "" + +#: ../../rect.rst:313 d54324445e3749e1a25aa77d529daed5 +msgid "" +"This class adheres to the Python sequence protocol, so components can be " +"accessed via their index, too. Also refer to :ref:`SequenceTypes`." +msgstr "" + +#: ../../rect.rst:314 57130e28ae034ad9998dc64ecbd910e2 +msgid "" +"Rectangles can be used with arithmetic operators -- see chapter " +":ref:`Algebra`." +msgstr "" + +#: ../../footer.rst:-1 64a8e55292e440d59f7ce66518d89731 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/shape.mo b/docs/locales/ja/LC_MESSAGES/shape.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/shape.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/shape.po b/docs/locales/ja/LC_MESSAGES/shape.po new file mode 100644 index 000000000..43b5d11fe --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/shape.po @@ -0,0 +1,1361 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../shape.rst:6 a1cc80d383794c3cb435c4c6ee97bde4 +msgid "Shape" +msgstr "" + +#: ../../shape.rst:8 37d213020d5a4d548df83e815ed0e286 +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 "" + +#: ../../shape.rst:10 92bfeba36df04589bf4b4464513bfe07 +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 "" + +#: ../../shape.rst:12 2d33b356753246ef8d94540310a7769d +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 "" + +#: ../../shape.rst:14 b4d4a6ae66df4d96974ad0bc45606dd1 +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 "" + +#: ../../shape.rst:16 8c6110dbab9d4387bcb0b2254e3e21b4 +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 "" + +#: ../../shape.rst:19 1a5127dcec9b4702b48da85395deb941 +msgid "**Method / Attribute**" +msgstr "" + +#: ../../shape.rst:19 decb9df8d9964d4a8aa9915071714e54 +msgid "**Description**" +msgstr "" + +#: ../../shape.rst:21 129235cb0e64469aac54868024a1d8fd +msgid ":meth:`Shape.commit`" +msgstr "" + +#: ../../shape.rst:21 f14081f827594684be72283dd1605406 +msgid "update the page's contents" +msgstr "" + +#: ../../shape.rst:22 af7b6707c483406fa99ff401eb843eb9 +msgid ":meth:`Shape.draw_bezier`" +msgstr "" + +#: ../../shape.rst:22 ca8664e0e9b749e8820d03b13dc7bdb4 +msgid "draw a cubic Bezier curve" +msgstr "" + +#: ../../shape.rst:23 ad8e310b901742298223e9ad32fda939 +msgid ":meth:`Shape.draw_circle`" +msgstr "" + +#: ../../shape.rst:23 08ff2ae5086448b0b6467848c2d2baaf +msgid "draw a circle around a point" +msgstr "" + +#: ../../shape.rst:24 c5fd0b1d47a848c9be4b808215c1fc47 +msgid ":meth:`Shape.draw_curve`" +msgstr "" + +#: ../../shape.rst:24 9ec32ae27f88443a98ddd1a4de4fbaf9 +msgid "draw a cubic Bezier using one helper point" +msgstr "" + +#: ../../shape.rst:25 89b4e0e2837a422aad2a2c2d75e2e52e +msgid ":meth:`Shape.draw_line`" +msgstr "" + +#: ../../shape.rst:25 7d33f669597f4c16ac59faeafa76ef03 +msgid "draw a line" +msgstr "" + +#: ../../shape.rst:26 191325c0e98240339ae4e2feb2cc994d +msgid ":meth:`Shape.draw_oval`" +msgstr "" + +#: ../../shape.rst:26 4eb2bdddb5ab452194b8032b04303d54 +msgid "draw an ellipse" +msgstr "" + +#: ../../shape.rst:27 79f0d19731594c1fab329c636af93715 +msgid ":meth:`Shape.draw_polyline`" +msgstr "" + +#: ../../shape.rst:27 1b21950a34904c64ba003b6657c6356c +msgid "connect a sequence of points" +msgstr "" + +#: ../../shape.rst:28 4bf0218daa1b4ffabff71e5e843b364a +msgid ":meth:`Shape.draw_quad`" +msgstr "" + +#: ../../shape.rst:28 5e99946e42874afebd2bc1ff6c5854e4 +msgid "draw a quadrilateral" +msgstr "" + +#: ../../shape.rst:29 0ce048cb8afa4bb083fc1ab4830c407e +msgid ":meth:`Shape.draw_rect`" +msgstr "" + +#: ../../shape.rst:29 a12eb407108b419a861470b0fc1f2292 +msgid "draw a rectangle" +msgstr "" + +#: ../../shape.rst:30 d612f08832064fbf93d3ce5feb27382e +msgid ":meth:`Shape.draw_sector`" +msgstr "" + +#: ../../shape.rst:30 b7525ea884bb43dd99e9656fb67e92a0 +msgid "draw a circular sector or piece of pie" +msgstr "" + +#: ../../shape.rst:31 61f03f4687094beb8871199f5e4b8b60 +msgid ":meth:`Shape.draw_squiggle`" +msgstr "" + +#: ../../shape.rst:31 bf135e136cc545d3aab0432ec6d79691 +msgid "draw a squiggly line" +msgstr "" + +#: ../../shape.rst:32 a3c9da7b58594baa9d6da5e14f317ec5 +msgid ":meth:`Shape.draw_zigzag`" +msgstr "" + +#: ../../shape.rst:32 9229b960ec5846a68af3ed58f788e3c0 +msgid "draw a zigzag line" +msgstr "" + +#: ../../shape.rst:33 e84a4aa4ac444aab8d59cefea3b2fbbf +msgid ":meth:`Shape.finish`" +msgstr "" + +#: ../../shape.rst:33 8619e5b07326446f845a3d2444d438fc +msgid "finish a set of draw commands" +msgstr "" + +#: ../../shape.rst:34 f08e07b5a2734f6b9b9d551b40880ed7 +msgid ":meth:`Shape.insert_text`" +msgstr "" + +#: ../../shape.rst:34 5fc91f3250734ebda1e5932c3754889a +msgid "insert text lines" +msgstr "" + +#: ../../shape.rst:35 29dd9c28de444051aac7e47ce4298461 +msgid ":meth:`Shape.insert_textbox`" +msgstr "" + +#: ../../shape.rst:35 18760471216849e297491bb1afc173ba +msgid "fit text into a rectangle" +msgstr "" + +#: ../../shape.rst:36 7f50bd3ed64b4feca3100c438be0d9eb +msgid ":attr:`Shape.doc`" +msgstr "" + +#: ../../shape.rst:36 c2e83aa7314f421ba1aae10c61c9fc5e +msgid "stores the page's document" +msgstr "" + +#: ../../shape.rst:37 d25908c2d68741b08c3d9b50ce1256bc +msgid ":attr:`Shape.draw_cont`" +msgstr "" + +#: ../../shape.rst:37 9e988d61d1ec4ce4957ef6fe90fead68 +msgid "draw commands since last :meth:`Shape.finish`" +msgstr "" + +#: ../../shape.rst:38 ee90095462ed4482aa306f9b512d2528 +msgid ":attr:`Shape.height`" +msgstr "" + +#: ../../shape.rst:38 220f2cf966914b5591c939ddfdfa0f7e +msgid "stores the page's height" +msgstr "" + +#: ../../shape.rst:39 dae3126861f44bb3bccee5d5ba1b48ea +msgid ":attr:`Shape.lastPoint`" +msgstr "" + +#: ../../shape.rst:39 70a04ea2328a479ca01df0ed5075bdc0 +msgid "stores the current point" +msgstr "" + +#: ../../shape.rst:40 86056e12b0884bdda17f78a8d78a0c23 +msgid ":attr:`Shape.page`" +msgstr "" + +#: ../../shape.rst:40 417c3e177e094e8bbea810e9e9939b1b +msgid "stores the owning page" +msgstr "" + +#: ../../shape.rst:41 df8c185ec1f346c2810d574b3422b50f +msgid ":attr:`Shape.rect`" +msgstr "" + +#: ../../shape.rst:41 43910930e9e74e2ca1aed074fec6b6e7 +msgid "rectangle surrounding drawings" +msgstr "" + +#: ../../shape.rst:42 963c3e78cfa342b0bff5b773c9eb63b6 +msgid ":attr:`Shape.text_cont`" +msgstr "" + +#: ../../shape.rst:42 4e9cf2fd8716420da60ad8582bf880c0 +msgid "accumulated text insertions" +msgstr "" + +#: ../../shape.rst:43 8e2a63259883413eaa4850294c9062bd +msgid ":attr:`Shape.totalcont`" +msgstr "" + +#: ../../shape.rst:43 c6640d1c31394eec9d9d7437e48654d8 +msgid "accumulated string to be stored in :data:`contents`" +msgstr "" + +#: ../../shape.rst:44 0298b34450db40f8a7d984f5957e8eed +msgid ":attr:`Shape.width`" +msgstr "" + +#: ../../shape.rst:44 8739c317748148e09f6eb8c6af51f4d8 +msgid "stores the page's width" +msgstr "" + +#: ../../shape.rst:47 db3135edd95e4412bec818f50e0bd840 +msgid "**Class API**" +msgstr "" + +#: ../../shape.rst:53 cef8185d996f4421a5572cff07816d5e +msgid "" +"Create a new drawing. During importing PyMuPDF, the *fitz.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 "" + +#: ../../shape.rst 319b33f8e4434af38471f7820ae98a58 +#: 37ca76c2a4844a288c9c30ce8902b358 3945309be57f4910b7e4a06026e25179 +#: 669d141ff4aa4f8b9e78fa4b00b1ba32 6d2e983e44f440d0b3026833cd367dde +#: 80a47ddf93794fa78a0e3113c206a057 9af504875dbe4e408ad3f7f5b6e1669d +#: a7ab661826fe461595f5cfc148e7bdb7 aa822d1f94cc4f598a6bf774068f6c3e +#: baa72e59d3374634975ac839d894e0fb cd0b128cba1e47858d4a2cef0e5f6fb3 +#: d611ea2c1bab44aba29beee0092082fb d9a9db8ea9db4c90aa15beed6945baab +#: e333a4fbbc9545099ba58cb8d7ed9e12 +msgid "Parameters" +msgstr "" + +#: ../../shape.rst:55 d3a085e5b3884025a8a6fb6bc1921661 +msgid "an existing page of a PDF document." +msgstr "" + +#: ../../shape.rst:60 a4b732faac8940ae92a0f13c25c4f4d4 +msgid "Draw a line from :data:`point_like` objects *p1* to *p2*." +msgstr "" + +#: ../../shape.rst:62 ../../shape.rst:76 ../../shape.rst:112 +#: 4243b381cca8446486d421cfaba71a91 b0e98ecc7b4044cfaff8d60c4d50ccc2 +#: cc51e74526a144e8b7c291f7c3258848 +msgid "starting point" +msgstr "" + +#: ../../shape.rst:64 ../../shape.rst:78 ../../shape.rst:114 +#: 8c198eb7078a44acb5ad00f8be8896c4 9b9514ab9238445ea1621b7bae5c56a7 +#: d3a92f66734e4bf7bcdb14d640af63a2 +msgid "end point" +msgstr "" + +#: ../../shape.rst 10374be6447a471bba3d8f35bccab800 +#: 158725872a214a1d9d0f1436b352fc5a 2682f174a40543e6a0dd188ba16c4fd6 +#: 2f3cb713f14a4ec9b37ac225cb61e40b 35ac22b839f74a2fb1ee9f775c0a9c91 +#: 3ff0d7049b784b558cc5df359466947b 540e4761804949c389dfa942c2112434 +#: 552049f879ae4a73973bba2791510aea 5978682721e945ec933ed7a7f7faad16 +#: 65cc659f9ee14a239429e61b682480be 8fc92c508cbf4201900072b8a895ed61 +#: b7d9821117054f94b84e663c84046c33 d6aa5c1ccc354423b73a99d701f0355c +msgid "Return type" +msgstr "" + +#: ../../shape.rst:66 ../../shape.rst:82 ../../shape.rst:118 +#: ../../shape.rst:127 ../../shape.rst:136 ../../shape.rst:155 +#: ../../shape.rst:171 ../../shape.rst:183 ../../shape.rst:205 +#: ../../shape.rst:222 ../../shape.rst:231 ../../shape.rst:441 +#: 284a2e4005fa4f68a50f44971a7bc43a 52ea2f8da93e4894a06087657d66ac64 +#: 5896d2707f504e758dd20404ccef6328 596a534221374c35b30d939f1272428d +#: 5af3a226956a40d48bf7abfa08f7b467 620ed79caba246b290c73197d045fbe7 +#: 6a17969f8a2f42bdbbb2c1676afdede6 89b95d27845847859fb171e554c86122 +#: 930a60b815654307be1cf849e7151a58 b1ef78b536f64873a7379305fcd9e997 +#: c0b1ff7771a9427fb884a95d53343248 ecc469b498704214b7429d01a05bdc01 +msgid ":ref:`Point`" +msgstr "" + +#: ../../shape.rst 0ed450dee8e0476eba6c1edead0e0bb9 +#: 10c7635d1ec94048828e5fcf283ca54c 16f1faaeef8f41a180363cdb76a736b9 +#: 1b9b7050294947a880429b14a9715207 1ca2c129763642778fdea339ff2b077a +#: 2f5738b4cd2b4d199ccfeb08960e902f 3df260890fc1464da9fd7e082e8e35a4 +#: 447594f9a38241258ca34b4d1548a962 8052e92bfb454ade887456efefda2435 +#: 89f94d00cbb3498f8d95e232649f9923 991566e70e0e48a381a54d1396b24487 +#: b6494adddf844a2494c1f9ff2a8b157f e4a387db5a404029b758b299d8dc7d94 +msgid "Returns" +msgstr "" + +#: ../../shape.rst:67 ../../shape.rst:83 ../../shape.rst:119 +#: 0b5841b2e7a3470abe1511cf3a1689ad 69a0438d27af4640a8be9c1251231db4 +#: 7cb887c76e43403dbfa74c6edd8ebb28 +msgid "the end point, *p2*." +msgstr "" + +#: ../../shape.rst:74 172f8505065e429d85dae1149a0d0724 +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 "" + +#: ../../shape.rst:80 e141c38a7db0400cbccd9c3e9d9ce751 +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 "" + +#: ../../shape.rst:87 a017c333e4c44e2b9aefe89c3fa62621 +msgid "" +"Here is an example of three connected lines, forming a closed, filled " +"triangle. Little arrows indicate the stroking direction." +msgstr "" + +#: ../../shape.rst:103 5b66ba66ccc94a6ab39401655e25fe76 +msgid "" +"Waves drawn are **not** trigonometric (sine / cosine). If you need that, " +"have a look at `draw.py `_." +msgstr "" + +#: ../../shape.rst:110 96522815f2344feaa9efe52fa9f44dfa +msgid "" +"Draw a zigzag line from :data:`point_like` objects *p1* to *p2*. " +"Otherwise works exactly like :meth:`Shape.draw_squiggle`." +msgstr "" + +#: ../../shape.rst:116 03dcf5b6397c4c998e4a9e625f5cfe1e +msgid "" +"the amplitude of the movement. The condition *2 * breadth < abs(p2 - p1)*" +" must be true to fit in at least one period." +msgstr "" + +#: ../../shape.rst:123 19e14bda4b754db399f0c0d419e886d1 +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 "" + +#: ../../shape.rst:125 18076cc17fbb492ba50ad39405d82a3f +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 "" + +#: ../../shape.rst:128 25a27705e3b64679bb70c4746dd8b59a +msgid "*points[-1]* -- the last point in the argument sequence." +msgstr "" + +#: ../../shape.rst:132 8dc98885eb324ee39b96d5fe1237d24f +msgid "" +"Draw a standard cubic Bézier curve from *p1* to *p4*, using *p2* and *p3*" +" as control points." +msgstr "" + +#: ../../shape.rst:134 bc9d0e8a74094290900c1d56e6b44e7e +msgid "All arguments are :data:`point_like` \\s." +msgstr "" + +#: ../../shape.rst:137 880098bc1b534f04b7440c6ff2c3089d +msgid "the end point, *p4*." +msgstr "" + +#: ../../shape.rst:139 49237b1d580d4fac930b28e37cc5efdd +msgid "" +"The points do not need to be different -- experiment a bit with some of " +"them being equal!" +msgstr "" + +#: ../../shape.rst:141 16a7538e3ec04fe6a02d3cbad2a2488f +msgid "Example:" +msgstr "" + +#: ../../shape.rst:147 ce02388a05644d10a440fad4add2f4ee +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:149 265e347d7c4a4f8abc21c5ae339dfaa4 +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:151 aa250094df2c462dbb2a845b51eae49c +msgid "" +":data:`rect_like` or :data:`quad_like`. *Changed in version 1.14.5:* " +"Quads are now also supported." +msgstr "" + +#: ../../shape.rst:151 29d9c781ce054151818499c605f0a1d9 +msgid ":data:`rect_like` or :data:`quad_like`." +msgstr "" + +#: ../../shape.rst:153 6db98e67c8d04630a4eaf0241e97b26f +msgid "*Changed in version 1.14.5:* Quads are now also supported." +msgstr "" + +#: ../../shape.rst:156 ddeaacbcd7ca41d2928f7861cb3447c1 +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 "" + +#: ../../shape.rst:163 8223d096003c42008647060b9d3bd1e9 +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 "" + +#: ../../shape.rst:165 23b06b7b2e3843cfa742c6e8b57d94ae +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 "" + +#: ../../shape.rst:167 ../../shape.rst:197 54c5514c59d047669dc538937ee6c85f +#: e821358de04d4d2a99c4ce0886930fc4 +msgid "the center of the circle." +msgstr "" + +#: ../../shape.rst:169 5904c9ea544f40e1a9a09c2e501c7c60 +msgid "the radius of the circle. Must be positive." +msgstr "" + +#: ../../shape.rst:172 7629fb1cf35245e8ab58131cb430dc3f +msgid "" +"`Point(center.x - radius, center.y)`. .. image:: images/img-drawcircle.*" +" :scale: 60" +msgstr "" + +#: ../../shape.rst:172 98edd47124e74166acd2ef6b50e18b0b +msgid "`Point(center.x - radius, center.y)`." +msgstr "" + +#: ../../shape.rst:179 e28be695a5044f1f918fe50f152cacb0 +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 "" + +#: ../../shape.rst:181 d669f3794e1f4df5a55ec5257b6ff393 +msgid "All arguments are :data:`point_like`." +msgstr "" + +#: ../../shape.rst:184 6f5379cf58e4497bbc2d1dc9e37acae3 +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:184 e62a6a016db04927af10433f07108dd0 +msgid "" +"the end point, *p3*. The following is a filled quarter ellipse segment. " +"The yellow area is oriented **clockwise:**" +msgstr "" + +#: ../../shape.rst:195 c593e3cc57c048108cb57acd9d1c07ba +msgid "" +"Draw a circular sector, optionally connecting the arc to the circle's " +"center (like a piece of pie)." +msgstr "" + +#: ../../shape.rst:199 fee8f7b24d40416d9540eb38deda1a6c +msgid "" +"one of the two end points of the pie's arc segment. The other one is " +"calculated from the *angle*." +msgstr "" + +#: ../../shape.rst:201 98569ab33db64e18ace237679634222f +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:203 1ebd31482c7a412e8c65332d5a17de01 +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:206 381d3f12b3ee4f82a2b516b4caae3dcd +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:206 e26c30ef092b487594ccbaf833eab34a +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:215 c05e6f8265264e88a41c4d4de7160a00 +msgid "Changed in v1.22.0: Added parameter *radius*." +msgstr "" + +#: ../../shape.rst:217 1b68e6fcb66d48b9b5bf5a11b8ea6136 +msgid "" +"Draw a rectangle. The drawing starts and ends at the top-left corner in " +"an anti-clockwise movement." +msgstr "" + +#: ../../shape.rst:219 a7b371cb5930488aaab0ae443feca4e6 +msgid "where to put the rectangle on the page." +msgstr "" + +#: ../../shape.rst:220 0d48c16582b94744905dab20e6fd19fd +#, 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 "" + +#: ../../shape.rst:223 4d7d48d4b2db4467a6823f34dc7e2bc6 +msgid "top-left corner of the rectangle." +msgstr "" + +#: ../../shape.rst:227 fbac3cdbfe624a2d86667e34f16cb2d8 +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 "" + +#: ../../shape.rst:229 637052605e3947aa8cb623ac867a50fc +msgid "where to put the tetragon on the page." +msgstr "" + +#: ../../shape.rst:232 86e5369ba30347e786240019ce0c4b17 +msgid ":attr:`Quad.ul`." +msgstr "" + +#: ../../shape.rst:266 16b26e1205e64b4cb7d0e859c143cc92 +msgid "" +"Finish a set of *draw*()* methods by applying :ref:`CommonParms` to all " +"of them." +msgstr "" + +#: ../../shape.rst:268 98efcc3f32c2462583d345de5163ad12 +msgid "" +"It has **no effect on** :meth:`Shape.insert_text` and " +":meth:`Shape.insert_textbox`." +msgstr "" + +#: ../../shape.rst:270 3af93ab0d2d94cb5845e38ef589c59d6 +msgid "" +"The method also supports **morphing the compound drawing** using " +":ref:`Point` *fixpoint* and :ref:`matrix` *matrix*." +msgstr "" + +#: ../../shape.rst:272 e8f616c901f44aa1901d378279c54711 +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 "" + +#: ../../shape.rst:274 410137597b874abaae4f4fcd23084cdf +msgid "" +"*(new in v1.18.1)* set transparency for stroke colors. Value < 0 or > 1 " +"will be ignored. Default is 1 (intransparent)." +msgstr "" + +#: ../../shape.rst:275 611ae8f8364c4be2aa51a9f058b40f30 +msgid "" +"*(new in v1.18.1)* set transparency for fill colors. Default is 1 " +"(intransparent)." +msgstr "" + +#: ../../shape.rst:277 b3e7545ee4f643b39e67702874f30aeb +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 "" + +#: ../../shape.rst:279 ce838028355f4931959b8c38ef280a7e +msgid "" +"*(new in v1.18.4)* the :data:`xref` number of an :data:`OCG` or " +":data:`OCMD` to make this drawing conditionally displayable." +msgstr "" + +#: ../../shape.rst:283 2851131b5e12463a84014d3b11458b90 +msgid "For each pixel in a shape, the following will happen:" +msgstr "" + +#: ../../shape.rst:285 d42238789a874ad4b65ae380ed3f487c +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 "" + +#: ../../shape.rst:287 2d63650033804048acb50674ed836c15 +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 "" + +#: ../../shape.rst:289 5ecbc6280e3149c9bc9519c74673e3c5 +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 "" + +#: ../../shape.rst:294 4799567c3bae4c0f85017bbb03a34b51 +msgid "Insert text lines start at *point*." +msgstr "" + +#: ../../shape.rst:296 1f67ae8eb7934c36831a41ceff931bf2 +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:296 8c5eea550b8345e195afb24e8a61668c +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 "" + +#: ../../shape.rst:301 54fd86f871514215aeea1712ff9151d6 +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 "" + +#: ../../shape.rst:303 0b890535129641839f9c71dd321b3be5 +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 "" + +#: ../../shape.rst:304 ../../shape.rst:343 54e8788cc27b4457ab963fba8ab03528 +#: fca8c8ed895241a68586a381ea48abdf +msgid "" +"*(new in v1.18.1)* set transparency for stroke colors. Negative values " +"and values > 1 will be ignored. Default is 1 (intransparent)." +msgstr "" + +#: ../../shape.rst:305 ../../shape.rst:344 8d80bfcea1b0491381ff9869c2c9a5f1 +#: ba77178543c24996ac6f1b1606a49b17 +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 "" + +#: ../../shape.rst:307 d8a634e4348f44d19098a93f5bffd140 +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 "" + +#: ../../shape.rst:309 ../../shape.rst:348 0464be6212cd4561b9d260ebe7570166 +#: ce3a72a262bc4bbb821794be74c4cb24 +msgid "" +"*(new in v1.18.4)* the :data:`xref` number of an :data:`OCG` or " +":data:`OCMD` to make this text conditionally displayable." +msgstr "" + +#: ../../shape.rst:312 0352f8b3b28247cca8297d0b6cd2eb85 +msgid "number of lines inserted." +msgstr "" + +#: ../../shape.rst:314 ../../shape.rst:360 27aa9bd0124d4200b34a57190728b826 +#: 2dcef62820ef43f6b11e989a0b9c68ab +msgid "For a description of the other parameters see :ref:`CommonParms`." +msgstr "" + +#: ../../shape.rst:333 888b13a03eda441d85d661492e07af77 +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 "" + +#: ../../shape.rst:335 1119c65106db4532811326cd4cbe29fe +msgid "the area to use. It must be finite and not empty." +msgstr "" + +#: ../../shape.rst:337 4a6d08f1fe0f4facb6739a274c025d60 +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:339 6f93b5cdedce4a2aa33d068da5f641c9 +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 "" + +#: ../../shape.rst:341 3da95872e8554090a4b74c1c92bd266c +msgid "" +"controls handling of tab characters *\\t* using the *string.expandtabs()*" +" method **per each line**." +msgstr "" + +#: ../../shape.rst:346 155aae0b713a42cb90a83c319917ea07 +msgid "" +"requests text to be rotated in the rectangle. This value must be a " +"multiple of 90 degrees. Default is 0 (no rotation). Effectively, four " +"different values are processed: 0, 90, 180 and 270 (= -90), 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 "" + +#: ../../shape.rst:351 c688c21efc24469d9ba8dc59f9a7fc08 +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:352 61344dff2bee49928f00034db05f8f47 +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:354 f39caa3724e84078b2559d5843789c96 +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:368 97d5bbf584f14b00a3e7377e7cfdbf45 +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 "" + +#: ../../shape.rst:370 2476e3777d574db2be4e8cae7dc3cf8c +msgid "**Do not forget to execute this method:**" +msgstr "" + +#: ../../shape.rst:372 d54739856ad14e88b32e7edef5b81a17 +msgid "" +"If a shape is **not committed, it will be ignored and the page will not " +"be changed!**" +msgstr "" + +#: ../../shape.rst:374 56e2139393734d319d07e5741f17c60a +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 "" + +#: ../../shape.rst:376 418e9d960a634182aa10e3ece60809f6 +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 "" + +#: ../../shape.rst:378 80e78f1079994267ac1a7ee81c41a318 +msgid "**---------- Attributes ----------**" +msgstr "" + +#: ../../shape.rst:382 b7005e49e2d44d98bb381eb6d532a471 +msgid "For reference only: the page's document." +msgstr "" + +#: ../../shape.rst 34840cef97b340e591a66fd33018160b +#: 37032b28708242efaa3f0ee394c28125 3cfea3d577214117a3f1807614524c48 +#: 5e09d0e599f446d7844e2636f862e24d 6a5efe1e2b634a85a32b5c1629eab85e +#: 76dd64299d2a4984b58ebe77246a06f1 bcaffb822a55451b9789fb1f3f2f7bf5 +#: cd9425eb32e04083b7cd0cfaefe84596 ec31a7ad419745a595680fd1c2d54372 +msgid "type" +msgstr "" + +#: ../../shape.rst:384 74956a89be1441b8b6d3f0e92c60024c +msgid ":ref:`Document`" +msgstr "" + +#: ../../shape.rst:388 01ca33dc606f41aa9f50bd5e1c50867f +msgid "For reference only: the owning page." +msgstr "" + +#: ../../shape.rst:390 eabb2203a4444c8a9cf61526ac87c5ad +msgid ":ref:`Page`" +msgstr "" + +#: ../../shape.rst:394 4555c20926e34e479242db63da385fbf +msgid "Copy of the page's height" +msgstr "" + +#: ../../shape.rst:396 ../../shape.rst:402 1b0391085a3d43d99686b536e5b62489 +#: 1fafb1127d8141c09ef6e55f4c18b514 +msgid "float" +msgstr "" + +#: ../../shape.rst:400 f75719b1825147fda6becec4397f3931 +msgid "Copy of the page's width." +msgstr "" + +#: ../../shape.rst:406 0efea0aef93c49e19e01ca2df7bec40d +msgid "" +"Accumulated command buffer for **draw methods** since last finish. Every " +"finish method will append its commands to :attr:`Shape.totalcont`." +msgstr "" + +#: ../../shape.rst:408 ../../shape.rst:414 ../../shape.rst:435 +#: 4205301f942744c68019c12a5e78946c 473d8d579487439cbcccf8634737189f +#: ac82227cdf3548779b9b2626ab2fa0a2 +msgid "str" +msgstr "" + +#: ../../shape.rst:412 652eefb3778e40c78d5a159d1e74da8e +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 "" + +#: ../../shape.rst:418 b9bba524c74743d7a786a579595f8104 +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.rst:420 b0922fa0d17846e9bc031de6e01e11b5 +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.rst:422 0d9570087fb14065a1d1da21ca10539e +msgid "" +"If you have used morphing and need a rectangle containing the morphed " +"objects, use the following code::" +msgstr "" + +#: ../../shape.rst:429 25b3a45662db446a96dd3b39ec1d8ee1 +msgid ":ref:`Rect`" +msgstr "" + +#: ../../shape.rst:433 62229ecf59614898bde166ff20ec44d8 +msgid "" +"Total accumulated command buffer for draws and text insertions. This will" +" be used by :meth:`Shape.commit`." +msgstr "" + +#: ../../shape.rst:439 2182c227bf634d04a9a25a31c92da72e +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.rst:444 5f375748921d415ea078cf5c974c8bd9 +msgid "Usage" +msgstr "" + +#: ../../shape.rst:445 09178bfc96174f7a99f62a64a0df9562 +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.rst:464 b02ace9efbdf4df0bcd705b7ff453ccd +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 "" + +#: ../../shape.rst:466 492d139946104c8996e91ed6430126bf +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 "" + +#: ../../shape.rst:468 24bf5748d7784c64a13c5a5732c5fe14 +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 "" + +#: ../../shape.rst:470 ab0252c0c1e84a7c848bd1732b658ffb +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:472 b470e20d8f7f4d4e9f23a792c338e7b2 +msgid "" +"**Only** *commit* **will update** the page's contents, the other methods " +"are basically string manipulations." +msgstr "" + +#: ../../shape.rst:475 a39c843075924ec781f79936e3b11141 +msgid "Examples" +msgstr "" + +#: ../../shape.rst:476 a7f3292be0f34b49a6f1979dab1420dc +msgid "Create a full circle of pieces of pie in different colors::" +msgstr "" + +#: ../../shape.rst:491 9c00274a9b644b048de46f55ba7a07e4 +msgid "Here is an example for 5 colors:" +msgstr "" + +#: ../../shape.rst:495 093dffa9574c4351be38c5af6af4a73b +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 "" + +#: ../../shape.rst:510 7c9a951d4e434a3a9fb9041a45196cbd +msgid "Here is the polygon for n = 7:" +msgstr "" + +#: ../../shape.rst:517 543cfcdeb9144138a50e784f752a2614 +msgid "Common Parameters" +msgstr "" + +#: ../../shape.rst:519 e556d5f2643e4327a16f23ef2293891c +msgid "**fontname** (*str*)" +msgstr "" + +#: ../../shape.rst:521 ef08ee043cc1455a8cba97db1fe5657c +msgid "In general, there are three options:" +msgstr "" + +#: ../../shape.rst:523 a7e81cc0b917466eb600b3668cf209bb +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 "" + +#: ../../shape.rst:524 404bc3d8ae714ba1ba2cc00916ece9b5 +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:525 e8a5c5f7d7ab4de1a65082afc1466719 +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:527 e5aabde17961479bb0f7c006411440b3 +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 "" + +#: ../../shape.rst:529 4fa1031117b148baae319c17a93af33d +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 "" + +#: ../../shape.rst:533 7d4d9b740e46452bbc4423365dd2a9cf +msgid "**fontfile** (*str*)" +msgstr "" + +#: ../../shape.rst:535 66bce8ab8ecd464a925e8bbcfb61eaf3 +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 "" + +#: ../../shape.rst:539 2272946bc76e471e9bd308d77f7e8bd2 +msgid "**set_simple** (*bool*)" +msgstr "" + +#: ../../shape.rst:541 7ede967a32744db59d98bb33014ea629 +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 "" + +#: ../../shape.rst:545 d77e1adbc3ac43f39ac38e1de4fb3b38 +msgid "**fontsize** (*float*)" +msgstr "" + +#: ../../shape.rst:547 7e642cb208424f889fbd06c0a4e81404 +msgid "Font size of text." +msgstr "" + +#: ../../shape.rst:551 dfaeb2d08f6843c9bcedc008b088347a +msgid "**dashes** (*str*)" +msgstr "" + +#: ../../shape.rst:553 ece129135e2847fe8131fca4af866310 +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 "" + +#: ../../shape.rst:555 5b762706fd724f088544aa0f0aa545cf +msgid "" +"A continuous line (no dashes) is drawn with `\"[] 0\"` or *None* or " +"`\"\"`. Examples:" +msgstr "" + +#: ../../shape.rst:557 efd183b0e8984a699f44f3ded19a8278 +msgid "" +"Specifying `\"[3 4] 0\"` means dashes of 3 and gaps of 4 pixels following" +" each other." +msgstr "" + +#: ../../shape.rst:558 c61a7c9ae5f64bd39f1a232fdd4af5ca +msgid "`\"[3 3] 0\"` and `\"[3] 0\"` do the same thing." +msgstr "" + +#: ../../shape.rst:560 5597b2ff0e604a76a65e98f7dcfa86bc +msgid "" +"For (the rather complex) details on how to achieve sophisticated dashing " +"effects, see :ref:`AdobeManual`, page 217." +msgstr "" + +#: ../../shape.rst:564 de94145dc5c943149c4df1064af80f6a +msgid "**color / fill** (*list, tuple*)" +msgstr "" + +#: ../../shape.rst:566 c810d22d9fc949efbbdf5ceba1234b7b +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 "" + +#: ../../shape.rst:568 d97ce49c9cbc432e974d54e5b41babcd +msgid "" +"To simplify color specification, method *getColor()* in *fitz.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 "" + +#: ../../shape.rst:570 bee4ada9f000499da0974ac4a01d3faa +msgid "" +"Please note that the term *color* usually means \"stroke\" color when " +"used in conjunction with fill color." +msgstr "" + +#: ../../shape.rst:572 4d5683c7dadc41e78d1d4aa43555d37f +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 "" + +#: ../../shape.rst:576 1c297afde91945728fa423945b9984d2 +msgid "**stroke_opacity / fill_opacity** (*floats*)" +msgstr "" + +#: ../../shape.rst:578 57662544bd4a46b28bb2e035b4865c05 +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 "" + +#: ../../shape.rst:580 65790f4ac1f94915967856475a04c4fa +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 "" + +#: ../../shape.rst:584 0b6116d23008483bb80424e5c31149ff +msgid "**border_width** (*float*)" +msgstr "" + +#: ../../shape.rst:586 25d7e0d956de4db8b6d241fa279ad0cc +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 "" + +#: ../../shape.rst:590 6f2e08819bdf4dacb4ba31f837ab41ff +msgid "**render_mode** (*int*)" +msgstr "" + +#: ../../shape.rst:592 49538045f524441b846069f70d4c04f9 +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 "" + +#: ../../shape.rst:594 75b260fe81b549a19ce1138e1f539947 +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 "" + +#: ../../shape.rst:595 42c2d89a9c7b4e039aefa988934dd33a +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 "" + +#: ../../shape.rst:596 7f43b793f74c4d2a8a3f510a06bb429f +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 "" + +#: ../../shape.rst:597 66a6dba8d58441c1a39ff017e2560f07 +msgid "" +"For render mode 3, the glyphs are neither stroked nor filled: the text " +"becomes invisible." +msgstr "" + +#: ../../shape.rst:599 7b4e2fe971fe4cfb8a0589a24c82b5ce +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 "" + +#: ../../shape.rst:605 e4a301a336284368b200b1662b0351d9 +msgid "**overlay** (*bool*)" +msgstr "" + +#: ../../shape.rst:607 1f846378ec93433ba8d4570c042ba5d0 +msgid "Causes the item to appear in foreground (default) or background." +msgstr "" + +#: ../../shape.rst:611 395103d4f1444ddc9eed54ca5b390f81 +msgid "**morph** (*sequence*)" +msgstr "" + +#: ../../shape.rst:613 2baa921ce9df4838b85a3b1038420187 +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 "" + +#: ../../shape.rst:615 e3b34005e3764c85b157fcfd47475162 +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 "" + +#: ../../shape.rst:619 cd88986d961c419f9d39604fb8f971bb +msgid "**lineCap (deprecated: \"roundCap\")** (*int*)" +msgstr "" + +#: ../../shape.rst:621 5f70f8053f604eb6be49a566743a0d4e +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 "" + +#: ../../shape.rst:623 ded4adcc3eda4336ae50a2b86eef6dc4 +msgid "*Changed in version 1.14.15*" +msgstr "" + +#: ../../shape.rst:627 440f32ceba214d41a02542f09a569004 +msgid "**lineJoin** (*int*)" +msgstr "" + +#: ../../shape.rst:629 e31e8b0e89394313af16e13a6c471c4d +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 "" + +#: ../../shape.rst:633 4cdf51edeb1e40968a8648c5f47b0b0d +msgid "**closePath** (*bool*)" +msgstr "" + +#: ../../shape.rst:635 7a9565eaccf543e28108fd711aa2d87e +msgid "" +"Causes the end point of a drawing to be automatically connected with the " +"starting point (by a straight line)." +msgstr "" + +#: ../../footer.rst:-1 93d6594e758841d3b491123602d15c61 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/story-class.mo b/docs/locales/ja/LC_MESSAGES/story-class.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/story-class.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/story-class.po b/docs/locales/ja/LC_MESSAGES/story-class.po new file mode 100644 index 000000000..1a1414736 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/story-class.po @@ -0,0 +1,648 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../story-class.rst:7 648a58ffe2024ed2b2ebcdaca385babd +msgid "Story" +msgstr "" + +#: ../../story-class.rst:11 46f749ddb38642ff9db86f8303c71828 +msgid "New in v1.21.0" +msgstr "" + +#: ../../story-class.rst:14 1df20f45244b478da8fdcdf22c757093 +msgid "**Method / Attribute**" +msgstr "" + +#: ../../story-class.rst:14 8e53bf6907ff4dbcbe375efbfb7e0726 +msgid "**Short Description**" +msgstr "" + +#: ../../story-class.rst:16 68a9cd16d50446e99f80fc86a9a4e03c +msgid ":meth:`Story.reset`" +msgstr "" + +#: ../../story-class.rst:16 7af66a02f8b944afaa2569b1e6b9349a +msgid "\"rewind\" story output to its beginning" +msgstr "" + +#: ../../story-class.rst:17 4e7c95983e7240b581efe277a99f702b +msgid ":meth:`Story.place`" +msgstr "" + +#: ../../story-class.rst:17 21036e0eaf1a4f00ae1e3e7d4702a8cc +msgid "compute story content to fit in provided rectangle" +msgstr "" + +#: ../../story-class.rst:18 f6f11f719fdc47cb9b2b6590a8574e13 +msgid ":meth:`Story.draw`" +msgstr "" + +#: ../../story-class.rst:18 7603d322fdcd4f7ab8c32c3fbc34a283 +msgid "write the computed content to current page" +msgstr "" + +#: ../../story-class.rst:19 b3f7fc6a4f0d4edbb55b1a921a3ae5b2 +msgid ":meth:`Story.element_positions`" +msgstr "" + +#: ../../story-class.rst:19 f5847b86f9c04539b3da44b402a02b1b +msgid "callback function logging currently processed story content" +msgstr "" + +#: ../../story-class.rst:20 0ddda4e8df0b4b6f96e637239205491f +msgid ":attr:`Story.body`" +msgstr "" + +#: ../../story-class.rst:20 20e4aeac684945a6a4566ff14c8f84a0 +msgid "the story's underlying :htmlTag:`body`" +msgstr "" + +#: ../../story-class.rst:21 dfa8bf7c96f64efbb18a5226edebefd4 +msgid ":meth:`Story.write`" +msgstr "" + +#: ../../story-class.rst:21 c476f20892574edfafd085718d348e6e +msgid "places and draws Story to a DocumentWriter" +msgstr "" + +#: ../../story-class.rst:22 09f5f3deee484a6e9c480edc06b66ab6 +msgid ":meth:`Story.write_stabilized`" +msgstr "" + +#: ../../story-class.rst:22 07ed3f03256d474f8d637f001cfe930d +msgid "iterative layout of html content to a DocumentWriter" +msgstr "" + +#: ../../story-class.rst:23 f01f18b9224848a6a1c8e409db15afe6 +msgid ":meth:`Story.write_with_links`" +msgstr "" + +#: ../../story-class.rst:23 443501f73dd34923b8990814f5fb83bf +msgid "like `write()` but also creates PDF links" +msgstr "" + +#: ../../story-class.rst:24 28a5dcb69bb544aea386d3abd0e06544 +msgid ":meth:`Story.write_stabilized_with_links`" +msgstr "" + +#: ../../story-class.rst:24 29a610de38b546919007b8662508c637 +msgid "like `write_stabilized()` but also creates PDF links" +msgstr "" + +#: ../../story-class.rst:27 85b945cb00fd4900b994d5a2800fc80e +msgid "**Class API**" +msgstr "" + +#: ../../story-class.rst:33 1ba3c88cf787415c96d48aef52d36b00 +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 "" + +#: ../../story-class.rst:36 d74a017e0a9443b4a9e3da04efdc29a4 +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 "" + +#: ../../story-class.rst:39 b598eb4336d847d7b563d7b3347490e1 +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 "" + +#: ../../story-class.rst:42 1c26f0a7463e4f139bcc81ce116aae6f +msgid "Here are some general remarks:" +msgstr "" + +#: ../../story-class.rst:44 8904d4b4fa024699ba7713861c0bb20d +msgid "" +"The :ref:`Story` constructor parses and validates the provided HTML to " +"create the DOM." +msgstr "" + +#: ../../story-class.rst:45 707417cf6d6c4df0b12854ab6d5b691d +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 "" + +#: ../../story-class.rst:50 349526eb712d41e590804ce050c890fa +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 "" + +#: ../../story-class.rst:53 f674deb512e64b2ab3b2fc21b02f83f6 +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 "" + +#: ../../story-class.rst:59 7597776a5f304800b2e9c63752503d80 +msgid "To work in the first of these styles, the following loop should be used:" +msgstr "" + +#: ../../story-class.rst:61 fe103289c4fe482e90d6fc29647a96dd +msgid "" +"Obtain a suitable device to write to; typically by requesting a new, " +"empty page from a :ref:`DocumentWriter`." +msgstr "" + +#: ../../story-class.rst:64 b2b35b7897db4faa8075c8f93e11b116 +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:67 ac72b94a47224662a43bedd2eeec3482 +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:72 70a83b8307d24c198557152a2ffaeab8 +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 "" + +#: ../../story-class.rst:81 b456748969fc427f93d908ed4ca54cc0 +msgid "Next, draw that rectangle out to the device with the `draw()` method." +msgstr "" + +#: ../../story-class.rst:82 26094def981e4b5782c44ccee2cac1f1 +msgid "" +"If the most recent call to `place()` indicated that all the story data " +"had fitted, stop now." +msgstr "" + +#: ../../story-class.rst:84 14912a23dc594a2eb48f736f4044f979 +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 "" + +#: ../../story-class.rst:87 aaaa635af83a49bc864221c59cd2d51e +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 "" + +#: ../../story-class.rst:92 0dba3a97210a46458e7fac6115e86c8b +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 "" + +#: ../../story-class.rst:94 6510df240b424d3da7b6dda04fd4a7fa +msgid "" +"Images may be part of a **story**. They will be placed together with any " +"surrounding text." +msgstr "" + +#: ../../story-class.rst:95 047b99d2943f4e1c85a12eae69f8666b +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 0db58c1397fa4685a8a2dee5bed6dc6a +#: 17bdfedc45ec42dc81564519ca3eda9c 1bfdc612aeec414ab644c2485b6f793d +#: 6d99fffad29e4a30a72819b73efabd7e 8a27532ae4ae4fadab8c8c2e284753a4 +#: a3383233b0204a549a84085eb9cce416 +msgid "Parameters" +msgstr "" + +#: ../../story-class.rst:99 1297f3ed34f24d29b45a2f8f9db9d031 +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 "" + +#: ../../story-class.rst:104 e2b684cd66284b398db5b8d5553318ac +msgid "CSS source code. If provided, must contain valid CSS specifications." +msgstr "" + +#: ../../story-class.rst:105 bd93a81c022a43b58f5bf521a4270871 +msgid "the default text font size." +msgstr "" + +#: ../../story-class.rst:106 285d3268f0a843b28c134c6821813d50 +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 = " +"fitz.Story(archive=fitz.Archive(\"myfolder\"))`, one can also shorter " +"write `story = fitz.Story(archive=\"myfolder\")`." +msgstr "" + +#: ../../story-class.rst:106 6ec581d6d9984e33b801e99395273f83 +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 "" + +#: ../../story-class.rst:108 db573c73158e4e6cba5700953a2a0e04 +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 = " +"fitz.Story(archive=fitz.Archive(\"myfolder\"))`, one can also shorter " +"write `story = fitz.Story(archive=\"myfolder\")`." +msgstr "" + +#: ../../story-class.rst:112 93937c0f339d47868f3e442ba5f2a559 +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:114 55a1ea6bfaca49b1ab00593f4750f2ad +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 "" + +#: ../../story-class.rst 62f8f75412244130b2f8c2aa3b56d562 +msgid "Return type" +msgstr "" + +#: ../../story-class.rst 55e82f3f940847a8aa60a74fca89196e +msgid "Returns" +msgstr "" + +#: ../../story-class.rst:117 a0d548773da5451eb57c1327faed4e27 +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 "" + +#: ../../story-class.rst:121 913718a3459948bca31650fd1c57eb9f +msgid "Write the content part prepared by :meth:`Story.place` to the page." +msgstr "" + +#: ../../story-class.rst:123 d6975974753744e09a929c1cf0113232 +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 "" + +#: ../../story-class.rst:124 551e8fec4d204bec8d607efb97b67a12 +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 "" + +#: ../../story-class.rst:128 2c0732fdde1b4845b5a88a4624343d63 +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-class.rst:130 3ce6e2be342141a7a690c548585b30fe +msgid "" +"*Story* will pass position information to *function*. This information " +"can for example be used to generate a Table of Contents." +msgstr "" + +#: ../../story-class.rst:132 db9d202a132343deab83b356a3677346 +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 "" + +#: ../../story-class.rst:133 9ad9cd906457436d98e2ee51609c7f7a +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 "" + +#: ../../story-class.rst:142 3f710fe0fc434822a9ea2c4d5a0f5620 +msgid "Rewind the story's document to the beginning for starting over its output." +msgstr "" + +#: ../../story-class.rst:146 08d98736204245eaaef43730333a41a6 +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 "" + +#: ../../story-class.rst:150 a88e08f3e1254469b440d5788a631625 +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-class.rst:155 620f2ae6029d4f8784b464969f4c1a3f +msgid "a `DocumentWriter` or None." +msgstr "" + +#: ../../story-class.rst:156 faa2e8ed213346c88d195612be35573e +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:156 303fbde69e774926a105a1f6245df23a +msgid "" +"a callable taking `(rect_num: int, filled: Rect)` and returning " +"`(mediabox, rect, ctm)`:" +msgstr "" + +#: ../../story-class.rst:158 ../../story-class.rst:200 +#: 9d1d319a1a65492da98df313cba56e38 b391f94a53e9443094d41b11880ef31d +msgid "mediabox:" +msgstr "" + +#: ../../story-class.rst:159 ../../story-class.rst:201 +#: 0b03398532aa4bfebbe4dfbd0006852c 9f5a9c0a5c00449e89a021da8461acbc +msgid "None or rect for new page." +msgstr "" + +#: ../../story-class.rst:160 ../../story-class.rst:203 +#: 20e67c9cc4904863b0431cf4617f040a d8885e73b5ea4effad27ddc25c50552a +msgid "rect:" +msgstr "" + +#: ../../story-class.rst:161 ../../story-class.rst:203 +#: 059b5b2d01fd4b8ab538743d1a0e4bde c00cd838a2dc493bb346fa2075e2e09a +msgid "The next rect into which content should be placed." +msgstr "" + +#: ../../story-class.rst:162 ../../story-class.rst:205 +#: 2d6258e5c2cf454ca48e7e4e029bd96f f33fb3f2be65449dbf99cde47f63dd28 +msgid "ctm:" +msgstr "" + +#: ../../story-class.rst:163 fbf561af4f5041d4aad2e320bd32656c +msgid "None or a `Matrix`." +msgstr "" + +#: ../../story-class.rst:164 248870a78e474c7f9b80d0ab7ef66b3f +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:164 d02e0a0a928e4bdf874b30a72fd32bba +msgid "None, or a callable taking `(position: ElementPosition)`: position:" +msgstr "" + +#: ../../story-class.rst:166 f4f74f315ae3421e94b578a53f748ede +msgid "An `ElementPosition` with an extra `.page_num` member." +msgstr "" + +#: ../../story-class.rst:167 c7dbb17d1d3b4f14a7a45dda6ddc906a +msgid "" +"Typically called multiple times as we generate elements that are headings" +" or have an id." +msgstr "" + +#: ../../story-class.rst:169 4a38aa31c9c54e228be1742142a13964 +msgid "" +"None, or a callable taking `(page_num, mediabox, dev, after)`; called at " +"start (`after=0`) and end (`after=1`) of each page." +msgstr "" + +#: ../../story-class.rst:175 d5ea4373ac544f46a6d58bc0ae15b8d5 +msgid "" +"Static method that does iterative layout of html content to a " +"`DocumentWriter`." +msgstr "" + +#: ../../story-class.rst:178 532a8550b36a40f58e74e85ae33655da +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:181 a8525f4040854de6af25545e8a6bb958 +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 "" + +#: ../../story-class.rst:187 bb0e755ec26e44c29a0d2526bd29e915 +msgid "" +"When the html from `contentfn()` becomes unchanged, we do a final " +"iteration using `writer`." +msgstr "" + +#: ../../story-class.rst:190 b6a12fb8d69a4952b856c1e575923cb0 +msgid "A `DocumentWriter`." +msgstr "" + +#: ../../story-class.rst:192 921a2587fade40d9b21cdc3fa82022c8 +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 "" + +#: ../../story-class.rst:197 c8a863ceb74c48c7ba490291ac167584 +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:198 1a1e3aae9d694004bc487c6c68e8a158 +msgid "" +"A callable taking `(rect_num: int, filled: Rect)` and returning " +"`(mediabox, rect, ctm)`:" +msgstr "" + +#: ../../story-class.rst:206 40548ee4636545d0afc67f464915139b +msgid "A `Matrix`." +msgstr "" + +#: ../../story-class.rst:207 4cf210e5560f443bbff96b675b56521f +msgid "" +"None, or a callable taking `(page_num, medibox, dev, after)`; called at " +"start (`after=0`) and end (`after=1`) of each page." +msgstr "" + +#: ../../story-class.rst:211 ../../story-class.rst:212 +#: 01db5e86d11f49fa90fdfbc3be5077ad 9bf011caf393487ba831f4c122363878 +msgid "." +msgstr "" + +#: ../../story-class.rst:213 9089c74997dc4b2a8220cdec7e7c3f66 +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 "" + +#: ../../story-class.rst:217 8cc34dd58e6d4f809c1ea8be04987364 +msgid "Returns:" +msgstr "" + +#: ../../story-class.rst:218 3eb712a6631a44f89dad915630b9eec0 +msgid "None." +msgstr "" + +#: ../../story-class.rst:222 ee0263488af14ec0ac45fe78745cea84 +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 "" + +#: ../../story-class.rst:228 2e0ab84ab13f4097b2c8b45ce4d1bf75 +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 "" + +#: ../../story-class.rst:234 08741e9ab85f4462b4c73e47b90c6607 +msgid "Element Positioning CallBack function" +msgstr "" + +#: ../../story-class.rst:236 4ef4fdf4cb9f4d9895227525cd8c3eaf +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:238 f0fc01703d5c4080925399792e8a576f +msgid "" +"A typical loop for executing a story with using this method would look " +"like this::" +msgstr "" + +#: ../../story-class.rst:270 e783aaf137e24e25a3f58552ba7ec5a1 +msgid "Attributes of the ElementPosition class" +msgstr "" + +#: ../../story-class.rst:271 9a9b324407df48da97d5f3fe72f4fb53 +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 "" + +#: ../../story-class.rst:273 50da38f7350947f9967720535818fb4d +msgid "" +"The parameter passed to the `recorder` function is an object with the " +"following attributes:" +msgstr "" + +#: ../../story-class.rst:275 6247f53b11364cc1b4adc27a3f5ee6b6 +msgid "`elpos.depth` (int) -- depth of this element in the box structure." +msgstr "" + +#: ../../story-class.rst:277 1d24dd18f8df4620b115e977775c92bc +msgid "" +"`elpos.heading` (int) -- the header level, 0 if no header, 1-6 for " +":htmlTag:`h1` - :htmlTag:`h6`." +msgstr "" + +#: ../../story-class.rst:279 e03471da97214d7dad320ecb1eaadeba +msgid "" +"`elpos.href` (str) -- value of the `href`attribute, or None if not " +"defined." +msgstr "" + +#: ../../story-class.rst:281 f1aa3832a1014d92be15faa9407b841a +msgid "`elpos.id` (str) -- value of the `id` attribute, or None if not defined." +msgstr "" + +#: ../../story-class.rst:283 49c2aeddbba344a39f77dfdd07a39237 +msgid "`elpos.rect` (tuple) -- element position on page." +msgstr "" + +#: ../../story-class.rst:285 183e540174d0428c862939367667a3d1 +msgid "`elpos.text` (str) -- immediate text of the element." +msgstr "" + +#: ../../story-class.rst:287 1bcbb90342be49938b446ff927c11b1b +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 "" + +#: ../../story-class.rst:289 d150aef461fd44469a9c11f9b247047d +msgid "`elpos.rect_num` (int) -- count of rectangles filled by the story so far." +msgstr "" + +#: ../../story-class.rst:291 d028b62d46994f0dbbf080e28e85ce98 +msgid "" +"`elpos.page_num` (int) -- page number; only present when using " +"`fitz.Story.write*()` functions." +msgstr "" + +#: ../../footer.rst:-1 2df0f02a4fd44dc590fcd35e2ba88c08 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/textpage.mo b/docs/locales/ja/LC_MESSAGES/textpage.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/textpage.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/textpage.po b/docs/locales/ja/LC_MESSAGES/textpage.po new file mode 100644 index 000000000..ef3ff05e0 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/textpage.po @@ -0,0 +1,1033 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../textpage.rst:7 5bf5601a30b047d49ea2ea5c79283d42 +msgid "TextPage" +msgstr "" + +#: ../../textpage.rst:9 719818e47edf4cebb283f196b6e4fd73 +msgid "" +"This class represents text and images shown on a document page. All " +":ref:`MuPDF document types` are supported." +msgstr "" + +#: ../../textpage.rst:11 10f119404f5c429ea2e07d87bea0afe8 +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 "" + +#: ../../textpage.rst:13 cea5d85a5d2d436ea86e276de5da0e34 +msgid "For a description of what this class is all about, see Appendix 2." +msgstr "" + +#: ../../textpage.rst:16 eee324dc059345a48b27f1046f55759b +msgid "**Method**" +msgstr "" + +#: ../../textpage.rst:16 46775121c4ae4b86ac3ac37463a47248 +msgid "**Description**" +msgstr "" + +#: ../../textpage.rst:16 89234e95703c4b6493da858a74ae4c91 +msgid "page get_text or search method" +msgstr "" + +#: ../../textpage.rst:18 c6ca58dceac04a1bae642c79ace1f42c +msgid ":meth:`~.extractText`" +msgstr "" + +#: ../../textpage.rst:18 b4d49b4b652946aeae7d0d6ed845a305 +msgid "extract plain text" +msgstr "" + +#: ../../textpage.rst:18 ../../textpage.rst:19 aa6b915d06f64ce2ab84d50b83b8beb3 +#: c8837221c5fd4f51abdc87e051751bff +msgid "\"text\"" +msgstr "" + +#: ../../textpage.rst:19 19f6a4ec341e4072beb491ba7353311b +msgid ":meth:`~.extractTEXT`" +msgstr "" + +#: ../../textpage.rst:19 b6abb0b79f5c49a9ad3ee9f51c0874f5 +msgid "synonym of previous" +msgstr "" + +#: ../../textpage.rst:20 abc27b22dbb34e97a16192ee6b14262b +msgid ":meth:`~.extractBLOCKS`" +msgstr "" + +#: ../../textpage.rst:20 52ad26541893472f8915c12c18170c81 +msgid "plain text grouped in blocks" +msgstr "" + +#: ../../textpage.rst:20 d386a0ea80c24fcab90ee4140431edee +msgid "\"blocks\"" +msgstr "" + +#: ../../textpage.rst:21 79655a5c2b9e42db9eef65a55fb3d30d +msgid ":meth:`~.extractWORDS`" +msgstr "" + +#: ../../textpage.rst:21 14d5cb6e66934cda8047f00bc2e91c4d +msgid "all words with their bbox" +msgstr "" + +#: ../../textpage.rst:21 08c1dd361a624bc48d60b9e54e058512 +msgid "\"words\"" +msgstr "" + +#: ../../textpage.rst:22 bde091b05bef4c82a3305c1e82eb447d +msgid ":meth:`~.extractHTML`" +msgstr "" + +#: ../../textpage.rst:22 d0e7d19293fd416eb00f714861a27b79 +msgid "page content in HTML format" +msgstr "" + +#: ../../textpage.rst:22 fef2cb7823664f76baf9039b2296c976 +msgid "\"html\"" +msgstr "" + +#: ../../textpage.rst:23 c9c9dd9092a74a33bab393588c61e3c1 +msgid ":meth:`~.extractXHTML`" +msgstr "" + +#: ../../textpage.rst:23 36b30ad0986040b598fa68e0f90a0c24 +msgid "page content in XHTML format" +msgstr "" + +#: ../../textpage.rst:23 4368116cb12a4f209f6c4dcd986b3453 +msgid "\"xhtml\"" +msgstr "" + +#: ../../textpage.rst:24 90a0bd5c62254d889881c78f5f5830e7 +msgid ":meth:`~.extractXML`" +msgstr "" + +#: ../../textpage.rst:24 8bca02c287c74e83aecfd8fe5bf2f809 +msgid "page text in XML format" +msgstr "" + +#: ../../textpage.rst:24 1cfaff21ba2842b5a9910caad44a7a22 +msgid "\"xml\"" +msgstr "" + +#: ../../textpage.rst:25 e60af6cd9b304b9f90c859a2d6c31f00 +msgid ":meth:`~.extractDICT`" +msgstr "" + +#: ../../textpage.rst:25 ../../textpage.rst:27 02f728d28ed140a385a7321136d87928 +#: 485bfae2d363476f9383a5e6a5663325 +msgid "page content in *dict* format" +msgstr "" + +#: ../../textpage.rst:25 c1fe2cdab6c847f3a990b26efa7c1577 +msgid "\"dict\"" +msgstr "" + +#: ../../textpage.rst:26 b16141309fd74f0899e0d2486c738545 +msgid ":meth:`~.extractJSON`" +msgstr "" + +#: ../../textpage.rst:26 ../../textpage.rst:28 5b4021fb472e4308a17871852878d2d9 +#: d89cb8a3999c4664a92923639a953ab5 +msgid "page content in JSON format" +msgstr "" + +#: ../../textpage.rst:26 b5f2648e60954761ac1c1dd0f3bb80f7 +msgid "\"json\"" +msgstr "" + +#: ../../textpage.rst:27 09fd10d6dc544ba8b66da5e44858ba48 +msgid ":meth:`~.extractRAWDICT`" +msgstr "" + +#: ../../textpage.rst:27 9168afc821da49be9a9c3bba71b83e00 +msgid "\"rawdict\"" +msgstr "" + +#: ../../textpage.rst:28 c4e63b6bbfa74d5aa024030d7269cf1d +msgid ":meth:`~.extractRAWJSON`" +msgstr "" + +#: ../../textpage.rst:28 85c2c34a802f4d418e9b1a688e79b548 +msgid "\"rawjson\"" +msgstr "" + +#: ../../textpage.rst:29 581a3c6db2a3406aa14c05ff3ef0d0d1 +msgid ":meth:`~.search`" +msgstr "" + +#: ../../textpage.rst:29 7b94bf692bb44ed69ed69ae900ffc23f +msgid "Search for a string in the page" +msgstr "" + +#: ../../textpage.rst:29 2c10f54b5db94222ac1e37327c82b1ca +msgid ":meth:`Page.search_for`" +msgstr "" + +#: ../../textpage.rst:32 a3e421784e5f4963bcfeafa14885bc6b +msgid "**Class API**" +msgstr "" + +#: ../../textpage.rst:40 bb1d53e2bfdd4ad088acb413709e229e +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 "" + +#: ../../textpage.rst 1e10f180ec0a4501bd23affb30965fdd +#: 32a8f2bbe8fa42a1af1300692666563f 469507b304ea49e5a49145cf00e152ac +#: 8877710ac7ac47e6b161719987479b12 92252bdb347b492d8efbb35d4db1b62e +#: 93748724b82d49709f169b0fffe7aaf3 a831efe64ae44d18a2d5cb6dab518404 +#: c260522c43f8427b8bb81058e42609d4 cc9b43697df544a786e0d1ec83f95dd4 +#: ed42deed17e7444f8b944163ae06d997 fd6a914a9e0c49a6bfecfa357b655305 +msgid "Return type" +msgstr "" + +#: ../../textpage.rst:47 2acffac417c44dd09c63af12a20dec2d +msgid "" +"Textpage content as a list of text lines grouped by block. Each list " +"items looks like this::" +msgstr "" + +#: ../../textpage.rst:51 f6a3bd87caaf4e6286607b60453e882d +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 "" + +#: ../../textpage.rst:53 8e34871914ea407f9f73f87181a71fb1 +msgid "" +"For an image block, its bbox and a text line with some image meta " +"information is included -- **not the image content**." +msgstr "" + +#: ../../textpage.rst:55 0541d1e608444007935633799d9b97e1 +msgid "" +"This is a high-speed method with just enough information to output plain " +"text in desired reading sequence." +msgstr "" + +#: ../../textpage.rst:61 269f4c4d7f734e9a8633c5516064f6d6 +msgid "" +"Textpage content as a list of single words with bbox information. An item" +" of this list looks like this::" +msgstr "" + +#: ../../textpage.rst:65 ad4516ddd5e84d8f8455260109755688 +msgid "" +"Everything delimited by spaces is treated as a *\"word\"*. 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:71 1913c6754e1544d8b8fa1e28edb897e3 +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 "" + +#: ../../textpage.rst:77 fbba5772842b46789f6fe9163378dceb +msgid "" +"Textpage content as a Python dictionary. Provides same information detail" +" as HTML. See below for the structure." +msgstr "" + +#: ../../textpage.rst:83 6eb2b85c53b548ba88a8098ef0c0fd21 +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.rst:89 5f13ce47ef0a4ceabe3146dfdaa9b771 +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.rst:95 d5d4d9ae15e4427f8a274c7f6b73ec22 +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.rst:101 21b00f8fe9294f3f873adbe178d112d6 +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.rst:107 74e55dd8ca564090aea064e5f6e4f652 +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.rst:113 0aee6b7682c94302a4b5cb51ada1a469 +msgid "Changed in v1.18.2" +msgstr "" + +#: ../../textpage.rst:115 73030db0179c4d6293d174f677424328 +msgid "Search for *string* and return a list of found locations." +msgstr "" + +#: ../../textpage.rst da970713212545b6ad05ee60eb7d97d5 +msgid "Parameters" +msgstr "" + +#: ../../textpage.rst:117 fce57edf869049f4b1ed6d50551f8387 +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 "" + +#: ../../textpage.rst:118 edc30740acde492da2d8ef4bbbaedf84 +msgid "return quadrilaterals instead of rectangles." +msgstr "" + +#: ../../textpage.rst 1967b88923224b0e8fa0caa6057b192d +msgid "Returns" +msgstr "" + +#: ../../textpage.rst:120 629ea6f35a08407880e8fbefa8ec6787 +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 "" + +#: ../../textpage.rst:122 5518848cd10548d88b955f11eb32aba2 +msgid "**Overview of changes in v1.18.2:**" +msgstr "" + +#: ../../textpage.rst:124 abc58964de014fd3af676f59c054e81e +msgid "The `hit_max` parameter has been removed: all hits are always returned." +msgstr "" + +#: ../../textpage.rst:125 dfc2140539e44caf96ac3b291c9aa2e5 +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 "" + +#: ../../textpage.rst:126 cc101c1725f1479f91526291607f0909 +msgid "**Hyphenated words** are now found." +msgstr "" + +#: ../../textpage.rst:127 766bd209343b48afb43c66c33b581e86 +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:129 84e5a50ed7fe472cbf9572868ef33faf +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 "" + +#: ../../textpage.rst:135 38af85c8db6f4cfe8f0e68b8c44d81fd +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 "" + +#: ../../textpage.rst:137 81caa30a4375452cb1c78b7cd789bb7b +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 "" + +#: ../../textpage.rst:142 5168339c903c412fbdcaa331803d6421 +msgid "Structure of Dictionary Outputs" +msgstr "" + +#: ../../textpage.rst:143 afd8f3a886314e18916dd2285387fcab +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 "" + +#: ../../textpage.rst:145 75ef3d202ff3488eb9d34dca41d018c2 +msgid "A **page** consists of a list of **block dictionaries**." +msgstr "" + +#: ../../textpage.rst:146 d03c0f3f755345efb1fddd058c6c0e12 +msgid "A (text) **block** consists of a list of **line dictionaries**." +msgstr "" + +#: ../../textpage.rst:147 85e37bc16300438db04684ab83eb44dc +msgid "A **line** consists of a list of **span dictionaries**." +msgstr "" + +#: ../../textpage.rst:148 32e1ddaf63a34a0ca72adea68967deb0 +msgid "" +"A **span** either consists of the text itself or, for the RAW variants, a" +" list of **character dictionaries**." +msgstr "" + +#: ../../textpage.rst:149 dc1c75123c69427aa83c91c925924d57 +msgid "" +"RAW variants: a **character** is a dictionary of its origin, bbox and " +"unicode." +msgstr "" + +#: ../../textpage.rst:151 d6a2980abbbc4732be0274fa73a382b3 +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 "" + +#: ../../textpage.rst:153 5162a1992cea4d038e9742b11ee6d916 +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 "" + +#: ../../textpage.rst:154 67f055ba32e643bdb77fcd6f51b680c0 +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 "" + +#: ../../textpage.rst:156 b3f334c98a884a908b88db779843a98f +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 "" + +#: ../../textpage.rst:158 0bc632d661734c7c948d3c5bc7421bf2 +msgid "" +"In the vast majority of cases, we are dealing with **horizontal text " +"only**, where bboxes provide entirely sufficient information." +msgstr "" + +#: ../../textpage.rst:160 d07257af48044726a7ab2e55282331d1 +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:162 b87e0bb99c734e35816f2807ec837cba +msgid ":meth:`recover_quad` -- the quad of a complete span" +msgstr "" + +#: ../../textpage.rst:163 48675ce819e244b0a2810dec6773a799 +msgid ":meth:`recover_span_quad` -- the quad of a character subset of a span" +msgstr "" + +#: ../../textpage.rst:164 fc4a9c54930145038c57b7cf02a47310 +msgid ":meth:`recover_line_quad` -- the quad of a line" +msgstr "" + +#: ../../textpage.rst:165 5a58340ddd224292b869aa3390ac8735 +msgid ":meth:`recover_char_quad` -- the quad of a character" +msgstr "" + +#: ../../textpage.rst:167 12ae4c5958794dacb8693993f0c6ffd6 +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 "" + +#: ../../textpage.rst:175 7d5c0c35f78349c59beeb0247b92a99f +msgid "Page Dictionary" +msgstr "" + +#: ../../textpage.rst:178 ../../textpage.rst:196 ../../textpage.rst:232 +#: ../../textpage.rst:244 ../../textpage.rst:266 ../../textpage.rst:326 +#: 044d62a93ba84f75ab5d608c39ce9257 1acd2a3a55df4267b4ebea42b810ed24 +#: 479c5ee4d77c405c9496cbcc0ba9cd20 8c024f82440b4afb99a834421d2ab790 +#: b07d56ce1c074641ae8a2612fc61bd13 f03956a866a04be28749a5fe49dc997a +msgid "**Key**" +msgstr "" + +#: ../../textpage.rst:178 ../../textpage.rst:196 ../../textpage.rst:232 +#: ../../textpage.rst:244 ../../textpage.rst:266 ../../textpage.rst:326 +#: 265ad37d14ba436fa759fa91e2824890 31af37d512ca4a6fae11a085db10dcec +#: 610034aebeb94aeaaacd83be3dea6660 aeccfa3904244c6384a3b195e8852df6 +#: be00d0ae4ff54e3985b303ffe68407e7 e62789f9377e457cb3947989cf8dc266 +msgid "**Value**" +msgstr "" + +#: ../../textpage.rst:180 ../../textpage.rst:202 +#: c13263111a904361b0f15d4952f7b380 edac4e0dcca34f3faea6f91ab27d60bb +msgid "width" +msgstr "" + +#: ../../textpage.rst:180 b5db42f1aed84717a632fde1e6fee6fb +msgid "width of the `clip` rectangle *(float)*" +msgstr "" + +#: ../../textpage.rst:181 ../../textpage.rst:203 +#: 34fbff6c3f0b4ba6b7bd2ee84c5fc3da f6d075ce38f94170a5f6a2f8aa85f92c +msgid "height" +msgstr "" + +#: ../../textpage.rst:181 359e146ef95c43fa9eaceb2f9ef6b979 +msgid "height of the `clip` rectangle *(float)*" +msgstr "" + +#: ../../textpage.rst:182 8c7dedfd55874bbba7b15ff2a8a0af87 +msgid "blocks" +msgstr "" + +#: ../../textpage.rst:182 66149c13a0c24cc7ac99df5444909e69 +msgid "*list* of block dictionaries" +msgstr "" + +#: ../../textpage.rst:186 094efb7a81a4444883507a62c2f8ec3c +msgid "Block Dictionaries" +msgstr "" + +#: ../../textpage.rst:187 7cb28ccb98d84946afcb7d0c8162e609 +msgid "" +"Block dictionaries come in two different formats for **image blocks** and" +" for **text blocks**." +msgstr "" + +#: ../../textpage.rst:189 fa8e165deec543aca662aa2b55f0dd2f +msgid "*(Changed in v1.18.0)* -- new dict key *number*, the block number." +msgstr "" + +#: ../../textpage.rst:190 9e942607324442f1bc44ac2a87694841 +msgid "" +"*(Changed in v1.18.11)* -- new dict key *transform*, the image " +"transformation matrix for image blocks." +msgstr "" + +#: ../../textpage.rst:191 6286c129989d465c85483146e2797e39 +msgid "" +"*(Changed in v1.18.11)* -- new dict key *size*, the size of the image in " +"bytes for image blocks." +msgstr "" + +#: ../../textpage.rst:193 6fd4df1a90544aa6b179d20580e7ecfd +msgid "**Image block:**" +msgstr "" + +#: ../../textpage.rst:198 ../../textpage.rst:234 +#: 2ca74b1fec19472190e4d61214e6a6a0 96105d8b60b14d7a8005a8dbc7ecea90 +msgid "type" +msgstr "" + +#: ../../textpage.rst:198 434304e865434f2ab7cc5b8ab885d8a2 +msgid "1 = image *(int)*" +msgstr "" + +#: ../../textpage.rst:199 ../../textpage.rst:235 ../../textpage.rst:246 +#: ../../textpage.rst:268 ../../textpage.rst:329 +#: 05b4e2358fcd42d8b7b56942c1031ab8 3c6da69c85eb491caae9cc016fd616fe +#: c4719053febc4fcfbe9a388edc2fb44a e27c4623639b426aa65824a9dcb1dc0a +#: fedf041988b046c58f4648ba264b5411 +msgid "bbox" +msgstr "" + +#: ../../textpage.rst:199 feb64917a6ee46d587d29d34e51be283 +msgid "image bbox on page (:data:`rect_like`)" +msgstr "" + +#: ../../textpage.rst:200 ../../textpage.rst:236 +#: 5204508f08014019ad28c9b9543d3481 94214e72ba3441fea0028d65e64b0a8b +msgid "number" +msgstr "" + +#: ../../textpage.rst:200 ../../textpage.rst:236 +#: 74e2d3b09ed142a0956081932250c0b1 cd0379aa521d46d49e7669d118f8e4f1 +msgid "block count *(int)*" +msgstr "" + +#: ../../textpage.rst:201 a7911109e3b04ab89f957e6b163d0247 +msgid "ext" +msgstr "" + +#: ../../textpage.rst:201 a99575411f9b4a6eb24d2bf92c450e64 +msgid "image type *(str)*, as file extension, see below" +msgstr "" + +#: ../../textpage.rst:202 a934340194ca4114a451a715a13d7a78 +msgid "original image width *(int)*" +msgstr "" + +#: ../../textpage.rst:203 0350a55990e649538bbf272a005882a2 +msgid "original image height *(int)*" +msgstr "" + +#: ../../textpage.rst:204 a35e3d4239604988ae3a29b77aa21f1e +msgid "colorspace" +msgstr "" + +#: ../../textpage.rst:204 c7efea177095441c8fefb27f2231729c +msgid "colorspace component count *(int)*" +msgstr "" + +#: ../../textpage.rst:205 dd6c8e8c09d545c1a695dc0238d03611 +msgid "xres" +msgstr "" + +#: ../../textpage.rst:205 4f6b129d6df8408f8cead9f9704d765a +msgid "resolution in x-direction *(int)*" +msgstr "" + +#: ../../textpage.rst:206 a502c041866c41ceb639d0c1fce7b3a7 +msgid "yres" +msgstr "" + +#: ../../textpage.rst:206 2384122811f14540b68b92adef8f9984 +msgid "resolution in y-direction *(int)*" +msgstr "" + +#: ../../textpage.rst:207 6ac5e8d6832048c8a866ec424fcbcb60 +msgid "bpc" +msgstr "" + +#: ../../textpage.rst:207 df65cac0fa10414bb3fd84a408aef7a0 +msgid "bits per component *(int)*" +msgstr "" + +#: ../../textpage.rst:208 49c62b61f3cc434092c6c6bfb94f1285 +msgid "transform" +msgstr "" + +#: ../../textpage.rst:208 2ff9fd38c18e4bb9a0b1290accfbc513 +msgid "matrix transforming image rect to bbox (:data:`matrix_like`)" +msgstr "" + +#: ../../textpage.rst:209 ../../textpage.rst:273 +#: 9c0585ee6108448fb838eea25610828b fa9c5933f14d4a269dfd22e2050621ec +msgid "size" +msgstr "" + +#: ../../textpage.rst:209 af8a4f21590241e2a847007406a32bc2 +msgid "size of the image in bytes *(int)*" +msgstr "" + +#: ../../textpage.rst:210 e22c8e1d059d48e8851fb00e8c448039 +msgid "image" +msgstr "" + +#: ../../textpage.rst:210 9f340af2cf9f4de58218c0ac98067eb2 +msgid "image content *(bytes)*" +msgstr "" + +#: ../../textpage.rst:213 542ee6d989954811bd3f5c1aad953106 +msgid "" +"Possible values of the \"ext\" key are \"bmp\", \"gif\", \"jpeg\", " +"\"jpx\" (JPEG 2000), \"jxr\" (JPEG XR), \"png\", \"pnm\", and \"tiff\"." +msgstr "" + +#: ../../textpage.rst:217 9ae1bca271b644f09e758b8e74b2d214 +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:219 5499ec26a96442859772bd9be5ed70d5 +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 "" + +#: ../../textpage.rst:221 ad1326fef8ae4333902ce420b11c8da0 +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 "" + +#: ../../textpage.rst:222 dc375fb940554ad3a0496dc368de521e +msgid "" +"Annotations may also contain images -- these will **not appear** in " +":meth:`Page.get_images`." +msgstr "" + +#: ../../textpage.rst:223 5f21daa03544424492bc2e16ba887f1a +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 "" + +#: ../../textpage.rst:224 0606a5c2c3b141b593c603bcc1640d14 +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 "" + +#: ../../textpage.rst:226 aab5c2b4c0734760bfa7fe3e31074b7b +msgid "" +"The image's \"transformation matrix\" is defined as the matrix, for which" +" the expression `bbox / transform == fitz.Rect(0, 0, 1, 1)` is true, " +"lookup details here: :ref:`ImageTransformation`." +msgstr "" + +#: ../../textpage.rst:229 92cbd1632c9b418a89cb79875584c7cc +msgid "**Text block:**" +msgstr "" + +#: ../../textpage.rst:234 4dc156b14a4d4aecba52357ac5b4a448 +msgid "0 = text *(int)*" +msgstr "" + +#: ../../textpage.rst:235 45349c5d7dbc4a2c80e7487427d46714 +msgid "block rectangle, :data:`rect_like`" +msgstr "" + +#: ../../textpage.rst:237 e81e2229001c41e99319594c6b47e839 +msgid "lines" +msgstr "" + +#: ../../textpage.rst:237 8d10160d27f44cefb80fb61c5cadd549 +msgid "*list* of text line dictionaries" +msgstr "" + +#: ../../textpage.rst:241 515990a3fbf54c9a898c2ddf2de89d2e +msgid "Line Dictionary" +msgstr "" + +#: ../../textpage.rst:246 ac5bf80e9d2e4e8088e91cedf53d0045 +msgid "line rectangle, :data:`rect_like`" +msgstr "" + +#: ../../textpage.rst:247 0493a824ec4741ca83d965f79d4553fd +msgid "wmode" +msgstr "" + +#: ../../textpage.rst:247 3e79e82d837e46e28dc2054f9fef98ee +msgid "writing mode *(int)*: 0 = horizontal, 1 = vertical" +msgstr "" + +#: ../../textpage.rst:248 546201db94074ad2bd60e8bce1b8a0fe +msgid "dir" +msgstr "" + +#: ../../textpage.rst:248 95bc66533a42408abbda4fcee7b14c64 +msgid "writing direction, :data:`point_like`" +msgstr "" + +#: ../../textpage.rst:249 be5dea74188d4020944e86da717f48e5 +msgid "spans" +msgstr "" + +#: ../../textpage.rst:249 3561f935bcdf4958a77ca1e40c173706 +msgid "*list* of span dictionaries" +msgstr "" + +#: ../../textpage.rst:252 f93ae354b5a64be2a4da42abe3ba4c53 +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. 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 "" + +#: ../../textpage.rst:258 66ec4bdb174d40bd8d56e84e549a161a +msgid "Span Dictionary" +msgstr "" + +#: ../../textpage.rst:260 e79bd795dee84b1eb1091a1edf467f7c +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:262 12e0f0b27f7e46388526d20456c4ffcd +msgid "Changed in version 1.14.17 Spans now also have a *bbox* key (again)." +msgstr "" + +#: ../../textpage.rst:263 9e0067cc7d8d423e834a77be75997b2b +msgid "Changed in version 1.17.6 Spans now also have an *origin* key." +msgstr "" + +#: ../../textpage.rst:268 af749b14fcfd4ec88047aa0808800221 +msgid "span rectangle, :data:`rect_like`" +msgstr "" + +#: ../../textpage.rst:269 ../../textpage.rst:328 +#: 37af8233475b4e85a64a37581e583557 b67cb6f42b8a4fa58cff86c6a0fa8650 +msgid "origin" +msgstr "" + +#: ../../textpage.rst:269 e7b499b9bfb64c4b8e40dfdd210d2779 +msgid "the first character's origin, :data:`point_like`" +msgstr "" + +#: ../../textpage.rst:270 96e50a0ca6104097ba4ab67df1bf09ac +msgid "font" +msgstr "" + +#: ../../textpage.rst:270 49f7b6c508d3426b9bd0e5f6385a745b +msgid "font name *(str)*" +msgstr "" + +#: ../../textpage.rst:271 af7873bf215241e9aaca1666c1620360 +msgid "ascender" +msgstr "" + +#: ../../textpage.rst:271 8957332f489f479e8c43a2f6aeac7896 +msgid "ascender of the font *(float)*" +msgstr "" + +#: ../../textpage.rst:272 fec0f4c8990241b096205798bf79298b +msgid "descender" +msgstr "" + +#: ../../textpage.rst:272 bb0dd4b49df1467882d476fdc552b5b8 +msgid "descender of the font *(float)*" +msgstr "" + +#: ../../textpage.rst:273 bb1cb5d3143b4e428295dbdd53ebda6b +msgid "font size *(float)*" +msgstr "" + +#: ../../textpage.rst:274 ff73ec71e2124b3091aa8ef22a308daf +msgid "flags" +msgstr "" + +#: ../../textpage.rst:274 2f0c933ade1242a595f806de4794336f +msgid "font characteristics *(int)*" +msgstr "" + +#: ../../textpage.rst:275 d2a012c664f74cf5b4f2241148174762 +msgid "color" +msgstr "" + +#: ../../textpage.rst:275 322723893c3f409386ed8b2cf2c85c3a +msgid "text color in sRGB format *(int)*" +msgstr "" + +#: ../../textpage.rst:276 96b473df85254cb0b1e1e9ac7145f7da +msgid "text" +msgstr "" + +#: ../../textpage.rst:276 a2678b7d2a6742948b95eb00e170eade +msgid "(only for :meth:`extractDICT`) text *(str)*" +msgstr "" + +#: ../../textpage.rst:277 3451c413b2414f21a7e96d258d035276 +msgid "chars" +msgstr "" + +#: ../../textpage.rst:277 8adce37442ed44db890a9dff48406a2b +msgid "(only for :meth:`extractRAWDICT`) *list* of character dictionaries" +msgstr "" + +#: ../../textpage.rst:280 b3f5654418a24ca09da45d262f4c1327 +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 "" + +#: ../../textpage.rst:282 c720ac685e8946cf98547194cdf51189 +msgid "" +"*(New in v1.18.5):* *\"ascender\"* and *\"descender\"* are font " +"properties, provided relative to fontsize 1. Note that descender is a " +"negative value. The following picture shows the relationship to other " +"values and properties." +msgstr "" + +#: ../../textpage.rst:287 6512a1017fd4470cbc0f13732b3bd0a9 +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 "" + +#: ../../textpage.rst:297 e31fa5b348dd47859c43350b6d8102ae +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 fontsize found in the PDF. So please ensure that " +"the height of `span[\"bbox\"]` is **larger** than `span[\"size\"]`." +msgstr "" + +#: ../../textpage.rst:299 e48f9a412d994cac978f7b3fc0146b4b +msgid "" +"You may request PyMuPDF to do all of the above automatically by executing" +" `fitz.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 "" + +#: ../../textpage.rst:301 7d475773c4ee4ddba5fc6de9ffe0ee2c +msgid "" +"The following shows the original span rectangle in red and the rectangle " +"with re-computed height in blue." +msgstr "" + +#: ../../textpage.rst:307 c226b549e2c449d1b14c5154d65ca7df +msgid "" +"*\"flags\"* is an integer, which represents font properties except for " +"the first bit 0. They are to be interpreted like this:" +msgstr "" + +#: ../../textpage.rst:309 302ce755b94544b48911749229583272 +msgid "" +"bit 0: superscripted (2\\ :sup:`0`) -- not a font property, detected by " +"MuPDF code." +msgstr "" + +#: ../../textpage.rst:310 a86ce289e04a4b63ae40890adda01792 +msgid "bit 1: italic (2\\ :sup:`1`)" +msgstr "" + +#: ../../textpage.rst:311 fa3dda347b034cd599c86b7f17faedfd +msgid "bit 2: serifed (2\\ :sup:`2`)" +msgstr "" + +#: ../../textpage.rst:312 57201f24923743998670ee0b88c6503f +msgid "bit 3: monospaced (2\\ :sup:`3`)" +msgstr "" + +#: ../../textpage.rst:313 59ea7d0657a442ab8be2152a8b365028 +msgid "bit 4: bold (2\\ :sup:`4`)" +msgstr "" + +#: ../../textpage.rst:315 80c34cda4a1449d7b2069d6afec0351f +msgid "Test these characteristics like so:" +msgstr "" + +#: ../../textpage.rst:320 1c92155d3dd24feba4826bd5861fc70b +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 "" + +#: ../../textpage.rst:323 639fb9c2423848ca8e12ec0aa94f78da +msgid "Character Dictionary for :meth:`extractRAWDICT`" +msgstr "" + +#: ../../textpage.rst:328 f991a6fa12a94e8e89c4089247a5a8a6 +msgid "character's left baseline point, :data:`point_like`" +msgstr "" + +#: ../../textpage.rst:329 ffd8bcf5dec54c879d59b32f4956fa65 +msgid "character rectangle, :data:`rect_like`" +msgstr "" + +#: ../../textpage.rst:330 16068a05064d4a57b580321b46117f0e +msgid "c" +msgstr "" + +#: ../../textpage.rst:330 4038dfcad7c94db49388f1b5dbc9bfe4 +msgid "the character (unicode)" +msgstr "" + +#: ../../textpage.rst:333 ee455bcf30674ec995674d29ee6b9662 +msgid "" +"This image shows the relationship between a character's bbox and its " +"quad: |textpagechar|" +msgstr "" + +#: ../../textpage.rst:335 05ee0679bf9d4d9bb9d5cd5f8f7e94b5 +#: 9090510a547b49f3b9b5be56b3d8e336 +msgid "textpagechar" +msgstr "" + +#: ../../textpage.rst:341 2ff6983629a24628938a7bcbeb1912e1 +msgid "Footnotes" +msgstr "" + +#: ../../textpage.rst:342 3e3a207f1477445289a72da20d3557b3 +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 "" + +#: ../../footer.rst:-1 e0941cb71ad447518b69c4f43f58a32a +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/textwriter.mo b/docs/locales/ja/LC_MESSAGES/textwriter.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/textwriter.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/textwriter.po b/docs/locales/ja/LC_MESSAGES/textwriter.po new file mode 100644 index 000000000..559106d2b --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/textwriter.po @@ -0,0 +1,586 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../textwriter.rst:7 44801fd6278345fdb9b258bca1318cef +msgid "TextWriter" +msgstr "" + +#: ../../textwriter.rst:9 9713efa99e8e428ea4d4d2e6160c41c7 +msgid "New in v1.16.18" +msgstr "" + +#: ../../textwriter.rst:11 58d49d2be6f241dd871b799d27378f78 +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 "" + +#: ../../textwriter.rst:13 10760da2838d4e9784a5a4ac168a5a58 +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 "" + +#: ../../textwriter.rst:15 31f1e1b6e92d4632a82177b5823ac31f +msgid "" +"A text writer is an elegant alternative to methods " +":meth:`Page.insert_text` and friends:" +msgstr "" + +#: ../../textwriter.rst:17 e361689e09504addbcac82fefaa2f488 +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:18 060471dac2d64b14928d72786df46900 +msgid "" +"**Free font choice:** Each text span has its own font and fontsize. This " +"lets you easily switch when composing a larger text." +msgstr "" + +#: ../../textwriter.rst:19 df6779b7d41e4c1499a34faa0058a7ea +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 "" + +#: ../../textwriter.rst:20 b2cb0e0a5aca4df5b669de5d8175007b +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 "" + +#: ../../textwriter.rst:21 b38d50de63a948d8ba96923da9d91a5a +msgid "" +"**Transparency support:** Parameter *opacity* is supported. This offers a" +" handy way to create watermark-style text." +msgstr "" + +#: ../../textwriter.rst:22 1860b6e664f44771a328bf13dd01c4b0 +msgid "" +"**Justified text:** Supported for any font -- not just simple fonts as in" +" :meth:`Page.insert_textbox`." +msgstr "" + +#: ../../textwriter.rst:23 e0010e79ffbe400c8025d1a72da3acb8 +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.rst:25 d87fb73bd232402daa4dc6aaf40170e7 +msgid "Using this object entails three steps:" +msgstr "" + +#: ../../textwriter.rst:27 a4667cbe4be24e7491caf3410c807e29 +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:28 84fafaf2b087444a8994043edc89d474 +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 "" + +#: ../../textwriter.rst:29 cd4f75165ab047cea5416953c7d2bb9b +msgid "Output the TextWriter object on some PDF page(s)." +msgstr "" + +#: ../../textwriter.rst:33 a8d68bc9905a4cacb3a1b796e73cf902 +msgid "" +"Starting with version 1.17.0, TextWriters **do support** text rotation " +"via the *morph* parameter of :meth:`TextWriter.write_text`." +msgstr "" + +#: ../../textwriter.rst:35 37e698f9914d417cb9824109c929dce3 +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 "" + +#: ../../textwriter.rst:39 89fb13561e594ff68d43b48665d379d7 +msgid "**Method / Attribute**" +msgstr "" + +#: ../../textwriter.rst:39 82e518e031884bc2970895ca2b67fb6b +msgid "**Short Description**" +msgstr "" + +#: ../../textwriter.rst:41 6638b88210944139b8f7bd6dc185d5c5 +msgid ":meth:`~TextWriter.append`" +msgstr "" + +#: ../../textwriter.rst:41 73661c1116f54e1587a4c2c62a8bd067 +msgid "Add text in horizontal write mode" +msgstr "" + +#: ../../textwriter.rst:42 17463fa5a4294588ac60bb873da7b216 +msgid ":meth:`~TextWriter.appendv`" +msgstr "" + +#: ../../textwriter.rst:42 084ea1857b984dcabce360ba7e7a45eb +msgid "Add text in vertical write mode" +msgstr "" + +#: ../../textwriter.rst:43 28eb7312291a4f8998edeebfa31fc903 +msgid ":meth:`~TextWriter.fill_textbox`" +msgstr "" + +#: ../../textwriter.rst:43 28512b98c256419d8341a3fee5d7c93d +msgid "Fill rectangle (horizontal write mode)" +msgstr "" + +#: ../../textwriter.rst:44 6f36fad6ec53446f9d050199d0d208ec +msgid ":meth:`~TextWriter.write_text`" +msgstr "" + +#: ../../textwriter.rst:44 19836ef3e5654f03b00a11c09e81aa84 +msgid "Output TextWriter to a PDF page" +msgstr "" + +#: ../../textwriter.rst:45 ba20da67a1fa4022addf585a4cd6f7a6 +msgid ":attr:`~TextWriter.color`" +msgstr "" + +#: ../../textwriter.rst:45 f92c07b13dc943598b39ff23dbcfc2d2 +msgid "Text color (can be changed)" +msgstr "" + +#: ../../textwriter.rst:46 993382a5e9174253a9862b115c59e644 +msgid ":attr:`~TextWriter.last_point`" +msgstr "" + +#: ../../textwriter.rst:46 bb459f95430c43c4ab4b1bbfb6093838 +msgid "Last written character ends here" +msgstr "" + +#: ../../textwriter.rst:47 a5af8e5cb4bd475488fc3a6803eac13a +msgid ":attr:`~TextWriter.opacity`" +msgstr "" + +#: ../../textwriter.rst:47 34b86460f29e4b1988a6a48884b32da4 +msgid "Text opacity (can be changed)" +msgstr "" + +#: ../../textwriter.rst:48 5144c3b2899443359ff4fa15585eab56 +msgid ":attr:`~TextWriter.rect`" +msgstr "" + +#: ../../textwriter.rst:48 f80c67d4217c4a1797db10ec1c144a6e +msgid "Page rectangle used by this TextWriter" +msgstr "" + +#: ../../textwriter.rst:49 a3fabc2fe2cc4331b7d5dd9c1a3c6a58 +msgid ":attr:`~TextWriter.text_rect`" +msgstr "" + +#: ../../textwriter.rst:49 9c6de395ffde432dbbd33006fb9821ef +msgid "Area occupied so far" +msgstr "" + +#: ../../textwriter.rst:53 60171c817c684b9a9abcfc8b042784a9 +msgid "**Class API**" +msgstr "" + +#: ../../textwriter.rst 58ccc521f293435da532a2c7b17421dc +#: 60b946368ff04dada1013ebdf3d6234a ae3b7733fb494f5b80804690ff9dd7b3 +#: c4e1548e856a4649ae5c8b764f24885a f1a0918c96bf46d9bd5d9ae75e300aea +msgid "Parameters" +msgstr "" + +#: ../../textwriter.rst:59 05b7562afacf4d5fb44f64801ef8030a +msgid "rectangle internally used for text positioning computations." +msgstr "" + +#: ../../textwriter.rst:60 0cd44354501845719c81dc059f8647b6 +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 "" + +#: ../../textwriter.rst:61 13ac74bcdc38436ab80bfcd3958321dd +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 "" + +#: ../../textwriter.rst:66 159f1b23a56b41228ed702496e2feab8 +msgid "*Changed in v1.18.9*" +msgstr "" + +#: ../../textwriter.rst:67 ../../textwriter.rst:98 +#: 46abb48b0c004735869568a60879feda 5d8ec8c36a634f248ac1d1831e31fc9f +msgid "*Changed in v1.18.15*" +msgstr "" + +#: ../../textwriter.rst:69 68f1d8637f41438c888bb7460309b3f4 +msgid "Add some new text in horizontal writing." +msgstr "" + +#: ../../textwriter.rst:71 ../../textwriter.rst:102 +#: 523f2b592353406199e4b12871d495ca 9b6f08cb83494f9cb0477639bd650f3d +msgid "start position of the text, the bottom left point of the first character." +msgstr "" + +#: ../../textwriter.rst:72 d56ec5f2cec34b8880ee96c09428ab47 +msgid "" +"a string of arbitrary length. It will be written starting at position " +"\"pos\"." +msgstr "" + +#: ../../textwriter.rst:73 ../../textwriter.rst:104 +#: 54f82f9cef05400590ea79ec9851e414 c2f98c1292864526bf2a96ae50edb992 +msgid "a :ref:`Font`. If omitted, `fitz.Font(\"helv\")` will be used." +msgstr "" + +#: ../../textwriter.rst:74 d2c8818539f34ee396320b6176f18306 +msgid "the fontsize, a positive number, default 11." +msgstr "" + +#: ../../textwriter.rst:75 ../../textwriter.rst:106 +#: 272c6548d22a4e81993c81490ffca0e1 fa13c4d64ae8401cb47830e2a2ccd5ca +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 "" + +#: ../../textwriter.rst:76 aba6fe5ee5884a3493d9bd09b4b2bddb +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 "" + +#: ../../textwriter.rst:77 7c0894b851b84851afc27b728b027533 +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 =" +" fitz.open() >>> page = doc.new_page() >>> text = \"PyMuPDF: the Python " +"bindings for MuPDF\" >>> font = fitz.Font(\"figo\") # choose a font with" +" small caps >>> tw = fitz.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:77 a310721c2bf74c1e8185e7aa0546dd9b +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 "" + +#: ../../textwriter.rst:88 d88f5cd864e14417a87a837530fc9bed +msgid "will produce this PDF text:" +msgstr "" + +#: ../../textwriter.rst 2f5d3341df5845c1bdfd1dcd22412a6d +#: 969d03e861504dee97e173ff8521dec4 f56c7ed05d424df09509f282d210c9c5 +msgid "Returns" +msgstr "" + +#: ../../textwriter.rst:93 ../../textwriter.rst:109 +#: 8b42f4bcf3f14605b164e5cc1d1f830f aa2f633dcaae4bc694f28afb4ff28aff +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 "" + +#: ../../textwriter.rst:100 53936bef46674f4ca1fe90db1ae593c6 +msgid "Add some new text in vertical, top-to-bottom writing." +msgstr "" + +#: ../../textwriter.rst:103 c1f53eb2f255450eb1804e13a13b48af +msgid "a string. It will be written starting at position \"pos\"." +msgstr "" + +#: ../../textwriter.rst:105 7ce603e02da54b2fb5cfa555fa05ee52 +msgid "the fontsize, a positive float, default 11." +msgstr "" + +#: ../../textwriter.rst:107 ../../textwriter.rst:131 +#: 1297de7ff5394fdfb00da311fac27a6e 298dd5344cef482f8c2501a35740f405 +msgid "*(New in v1.18.15)* see :meth:`append`." +msgstr "" + +#: ../../textwriter.rst:113 7a6b3b4a99294bdeab3f01043a1efa12 +msgid "" +"Changed in 1.17.3: New parameter `pos` to specify where to start writing " +"within rectangle." +msgstr "" + +#: ../../textwriter.rst:114 32dcc4809482416cb633b036c49a5106 +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 "" + +#: ../../textwriter.rst:115 cd7cda793f0a41099e821fd0c756bd00 +msgid "Changed in v1.18.15: Prefer small caps if supported by the font." +msgstr "" + +#: ../../textwriter.rst:117 3afe7548643d4ba9abfc282a988f321f +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 "" + +#: ../../textwriter.rst:119 e3760c1cc0654d8180a2cfaf0cf8dcc5 +msgid "the area to fill. No part of the text will appear outside of this." +msgstr "" + +#: ../../textwriter.rst:120 e127b220085c4d8c85f0b5ac6e1e42ab +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 "" + +#: ../../textwriter.rst:121 6aaaf696c230473f87cecec2960d2cb5 +msgid "" +"*(new in v1.17.3)* start storing at this point. Default is a point near " +"rectangle top-left." +msgstr "" + +#: ../../textwriter.rst:122 c47cca0a803f4dd9900071657611947a +msgid "the :ref:`Font`, default `fitz.Font(\"helv\")`." +msgstr "" + +#: ../../textwriter.rst:123 90de752b75a24fb59da9d7e7e6096c3f +msgid "the fontsize." +msgstr "" + +#: ../../textwriter.rst:124 f35c8674d5574d63a7b829f180941e62 +msgid "" +"text alignment. Use one of TEXT_ALIGN_LEFT, TEXT_ALIGN_CENTER, " +"TEXT_ALIGN_RIGHT or TEXT_ALIGN_JUSTIFY." +msgstr "" + +#: ../../textwriter.rst:125 0f26a97823be4089ad331c38243af9f9 +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 "" + +#: ../../textwriter.rst:126 fb9d7441c07a46c3b198da8109c245fe +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:126 56af91d91b284298b5e70b1e1c6a3d85 +msgid "" +"on text overflow do nothing, warn, or raise an exception. Overflow text " +"will never be written. **Changed in v1.18.9:**" +msgstr "" + +#: ../../textwriter.rst:128 dc393116ff3d4f0b8b018b85a659fd79 +msgid "Default is *None*." +msgstr "" + +#: ../../textwriter.rst:129 94b5643c34b74c579fed3543b0edc464 +msgid "The list of overflow lines will be returned." +msgstr "" + +#: ../../textwriter.rst 0e95ca862e404ebe9646ddeecc2788d9 +#: 1fa3a39b04e34c6ea7a33051248232b1 4e64e55c5b74462aae45b5060658f99b +#: b4f6fb230ca046bcb3bb98563ade7836 e90d1ff4c9c14d55bb3b7b0e86c24f49 +#: f78cf6844c174f0485acef1ae2362720 +msgid "Return type" +msgstr "" + +#: ../../textwriter.rst:134 cb1353753d674822a3e8f2a50362d901 +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 "" + +#: ../../textwriter.rst:136 41926b860d3a42988482697b47e56a34 +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 "" + +#: ../../textwriter.rst:141 3c9efc7fcbb8424e80b2cce89bbc308c +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.rst:143 c8710cf3918845ed8c853fc54ba447b8 +msgid "write to this :ref:`Page`." +msgstr "" + +#: ../../textwriter.rst:144 ../../textwriter.rst:145 +#: e03b54e71b864538aefc71a8816f6662 e79924201eda4a52bfe34333b8ef7f37 +msgid "override the value of the TextWriter for this output." +msgstr "" + +#: ../../textwriter.rst:146 29f337b9f9a546a9a904e50af6f4ae21 +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 "" + +#: ../../textwriter.rst:147 2883f6fd0b3d443a8e5865a00c9166f8 +msgid "put in foreground (default) or background." +msgstr "" + +#: ../../textwriter.rst:148 3836385b2ae74915bbc4dc6ad78b9a93 +msgid "*(new in v1.18.4)* the :data:`xref` of an :data:`OCG` or :data:`OCMD`." +msgstr "" + +#: ../../textwriter.rst:149 aa546896546c4059b6a41a1ba2bb1429 +msgid "" +"The PDF `Tr` operator value. Values: 0 (default), 1, 2, 3 (invisible). " +".. image:: images/img-rendermode.*" +msgstr "" + +#: ../../textwriter.rst:149 3d11fa3f913d4c6aaa463e467788d04f +msgid "The PDF `Tr` operator value. Values: 0 (default), 1, 2, 3 (invisible)." +msgstr "" + +#: ../../textwriter.rst:156 d7d488f00b38451482a470917ef258c0 +msgid "The area currently occupied." +msgstr "" + +#: ../../textwriter.rst:158 ../../textwriter.rst:182 +#: 78e6832754464b43bca4991f3d18acc7 c580de5251634d34b263f783c697788e +msgid ":ref:`Rect`" +msgstr "" + +#: ../../textwriter.rst:162 fcd03d28ea9547e28f61d9e15f6ce3ff +msgid "" +"The \"cursor position\" -- a :ref:`Point` -- after the last written " +"character (its bottom-right)." +msgstr "" + +#: ../../textwriter.rst:164 25be25f8960c49bfa11e1ef0df8356e6 +msgid ":ref:`Point`" +msgstr "" + +#: ../../textwriter.rst:168 2c710ee458a74872ada7ace5b7ecb539 +msgid "The text opacity (modifiable)." +msgstr "" + +#: ../../textwriter.rst:174 6adf6ce4428549bcab67674a3d7cdaf7 +msgid "The text color (modifiable)." +msgstr "" + +#: ../../textwriter.rst:180 785687532792460a8e02d952d7e45c5b +msgid "" +"The page rectangle for which this TextWriter was created. Must not be " +"modified." +msgstr "" + +#: ../../textwriter.rst:185 5abe42f2edd342e3805fa49e27602eed +msgid "" +"To see some demo scripts dealing with TextWriter, have a look at `this " +"`_ " +"repository." +msgstr "" + +#: ../../textwriter.rst:187 eb199cbffaa3480d9b7a0449f1fe449f +msgid "Opacity and color apply to **all the text** in this object." +msgstr "" + +#: ../../textwriter.rst:188 1879250c517248079dc61e5cdad26696 +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.rst:189 301946f20ea94f27bc319807411f3acc +msgid "" +"Appending items or text boxes can occur in arbitrary order: only the " +"position parameter controls where text appears." +msgstr "" + +#: ../../textwriter.rst:190 c9d8b62fae3f4cb6a909266e67f70103 +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 "" + +#: ../../textwriter.rst:191 ac9ca51775964d7e99d207ca5207d88c +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 "" + +#: ../../textwriter.rst:192 4454ebacffa14748871ada44289fd21e +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 "" + +#: ../../footer.rst:-1 bd0eab72c65045b986fde2c2323b9106 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/the-basics.mo b/docs/locales/ja/LC_MESSAGES/the-basics.mo new file mode 100644 index 000000000..d54a1d7be Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/the-basics.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/the-basics.po b/docs/locales/ja/LC_MESSAGES/the-basics.po new file mode 100644 index 000000000..10eeba6a1 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/the-basics.po @@ -0,0 +1,669 @@ +# 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" + +#: ../../the-basics.rst:8 d99474b08e9d4daf91fd5b6e65b88ef9 +msgid "The Basics" +msgstr "基本" + +#: ../../the-basics.rst:13 547677209e264c668d1ce66612bc3fe1 +msgid "Supported File Types" +msgstr "サポートされているファイルタイプ" + +#: ../../the-basics.rst:15 1333787e8f40421bb3bd33da7e84d816 +msgid ":title:`PyMuPDF` supports the following file types:" +msgstr ":title:`PyMuPDF` は以下のファイルタイプをサポートしています：" + +#: ../../the-basics.rst:151 d05a318a72824a6a87255d6c646e88b5 +msgid "Opening a File" +msgstr "ファイルを開く" + +#: ../../the-basics.rst:154 d2331a7466454d60a22dc0ed095b6d56 +msgid "To open a file, do the following:" +msgstr "ファイルを開くには、以下の手順を実行してください：" + +#: ../../the-basics.rst:168 274aa6e17a0a4aff885b1b6411def711 +msgid "Opening with :index:`a Wrong File Extension `" +msgstr "間違ったファイル拡張子でファイルを開く" + +#: ../../the-basics.rst:170 b10e3d6460ad4c8ea2cd724dda43009f +msgid "" +"If you have a document with a wrong file extension for its type, you can " +"still correctly open it." +msgstr "" +"もしドキュメントのファイル拡張子がその種類に対して間違っていても、" +"正しく開くことができます。" + +#: ../../the-basics.rst:172 35a5458f757d499a9fc8b592dbd410f1 +msgid "Assume that *\"some.file\"* is actually an XPS. Open it like so:" +msgstr "*\"some.file\"* が実際にXPSファイルだと仮定して、以下のようにして開いてください：" + +#: ../../the-basics.rst:188 ../../the-basics.rst:226 ../../the-basics.rst:277 +#: ../../the-basics.rst:336 ../../the-basics.rst:381 ../../the-basics.rst:423 +#: ../../the-basics.rst:526 ../../the-basics.rst:572 ../../the-basics.rst:625 +#: ../../the-basics.rst:721 ../../the-basics.rst:827 ../../the-basics.rst:891 +#: ../../the-basics.rst:1093 094e37ab72ad47eea71a3efe59800261 +#: 1102de5a8c06425fb5f4adad9fb0014b 371e654147c04993b024a6836102367b +#: 7ab1ee9cbbd84fa5a2034a1a02d94972 9248e4f1b3b3493192d849b8f4619e01 +#: 9336e008ca884bcd837f84a2ec43a78c a90ade6ec4d94aacabf839db2903efea +#: b47b4baed4a24d67968c2129682c10f3 b8b22c8f757843be856ebb66b973e867 +#: c2c6764e96ad454cb9c2d85a302c9262 cb4437b424a545a1814949a1b4bb856c +#: eea3167449f943be9351ab834936e3a4 f5a41dbb5b79418e812a1534d07cacbf +msgid "**Taking it further**" +msgstr "**さらに進む**" + +#: ../../the-basics.rst:190 91284b1523224c9ca7cd117298209c5f +msgid "" +"There are many file types beyond :title:`PDF` which can be opened by " +":title:`PyMuPDF`, for more details see the list of :ref:`supported file " +"types`." +msgstr "" +"「PyMuPDF」で開くことができるのは、:title:`PDF` に限らず、多くのファイルタイプがあります。詳細については、:ref:`サポートされているファイルタイプのリスト` をご覧ください。" + +#: ../../the-basics.rst:192 2715e58bd035400da01745003ef8fc9b +msgid "" +":title:`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パッケージがこのような操作をサポートしています。また、詳細な説明についてはドキュメントの章を参照してください。" + +#: ../../the-basics.rst:194 ea10b57f99744caea4b85b9af6fd0d77 +msgid "" +"If :title:`PyMuPDF` encounters a file with an unknown / missing " +"extension, it will try to open it as a :title:`PDF`. So in these cases " +"there is no need for additional precautions. Similarly, for memory " +"documents, you can just specify `doc=fitz.open(stream=mem_area)` to open " +"it as a :title:`PDF` document." +msgstr ":title:`PyMuPDF` が不明な/欠落している拡張子のファイルに遭遇した場合、それをPDFとして開こうと試みます。したがって、これらの場合は追加の注意が必要ありません。同様に、メモリ上のドキュメントの場合は、`doc=fitz.open(stream=mem_area)` と指定するだけでPDFドキュメントとして開くことができます。 +" + +#: ../../the-basics.rst:196 b7e78a12187f424c84decd7216f0ad84 +msgid "" +"If you attempt to open an unsupported file then :title:`PyMuPDF` will " +"throw a file data error." +msgstr "サポートされていないファイルを開こうとした場合、PyMuPDFはファイルデータエラーをスローします。" + +#: ../../the-basics.rst:204 9394464938f146f2b8e393ebdbe22d00 +msgid "Extract text from a :title:`PDF`" +msgstr ":title:`PDF` からテキストを抽出する" + +#: ../../the-basics.rst:206 23702d468819429ab9754e26a1da57d3 +msgid "To extract all the text from a :title:`PDF` file, do the following:" +msgstr ":title:`PDF` ファイルからすべてのテキストを抽出するには、以下の手順を実行してください：" + +#: ../../the-basics.rst:228 ../../the-basics.rst:279 +#: 53bdc9c7e5884eae88e9b1e220f13e89 c2a042d2aef943b2983ff915d25a1937 +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:230 ../../the-basics.rst:281 ../../the-basics.rst:345 +#: ../../the-basics.rst:387 ../../the-basics.rst:427 ../../the-basics.rst:459 +#: ../../the-basics.rst:489 ../../the-basics.rst:532 ../../the-basics.rst:576 +#: ../../the-basics.rst:632 ../../the-basics.rst:661 ../../the-basics.rst:692 +#: ../../the-basics.rst:794 ../../the-basics.rst:853 ../../the-basics.rst:895 +#: ../../the-basics.rst:963 ../../the-basics.rst:1025 ../../the-basics.rst:1105 +#: 169e6572e8c14756b621edbda2f5777d 2869972d7fae414691a69f49673a0c63 +#: 5d0a57e242a0490e94fab40a6763e952 76875aaae3f84b5cb1af8e282bf389a9 +#: 7725513d70c1413ba00015669652f488 7c6558e2d0d84476a0ff74aa838b3b84 +#: 8bbc05a399e543e18b0f78f6d49b7e71 93ce68059d5249e882c84b24397862af +#: 965b8289442b4bf087a1a20ed673cd23 96624d0f387b42189f3c18c66f7c3a36 +#: a1d804566b9d4fb4b404a62f6a9353b8 bd1c54cb4aa14fc698389afad4ce87b8 +#: bd2b34ab555842b88e3155dda02033c1 c0706a3627904de0846591e03b9262d9 +#: c5c4b95a274e404ebe5da0bc2d69f4fb f42bfa738eb5424b8d4ab2d58af86791 +#: f515c44389aa4f91b01281cffafdb75a f5dc8ec9202241c8b96f6daef5cc7800 +msgid "**API reference**" +msgstr "**APIリファレンス**" + +#: ../../the-basics.rst:232 a3cc47bbdee4488d8e5978466b80a143 +msgid ":meth:`Page.get_text`" +msgstr ":meth:`Page.get_text`" + +#: ../../the-basics.rst:240 8d103299825141fb9650eb8a282961a4 +msgid "Extract images from a :title:`PDF`" +msgstr ":title:`PDF` から画像を抽出する" + +#: ../../the-basics.rst:242 21c64e99c2f944b99dee2024a828831b +msgid "To extract all the images from a :title:`PDF` file, do the following:" +msgstr ":title:`PDF` すべての画像を抽出するには、以下の手順を実行してください：" + +#: ../../the-basics.rst:283 463842ad4e4d4e6d8330f145a4dff9e5 +msgid ":meth:`Page.get_images`" +msgstr "" + +#: ../../the-basics.rst:284 41eb56738b6b4cf89692ab3f345c8d65 +msgid ":ref:`Pixmap`" +msgstr "" + +#: ../../the-basics.rst:294 8432f1e74bb44752b5cbcad06a010ea8 +msgid "Merging :title:`PDF` files" +msgstr ":title:`PDF` ファイルの結合" + +#: ../../the-basics.rst:296 3cb8a3888abd4edba1249c8d8cf87008 +msgid "To merge :title:`PDF` files, do the following:" +msgstr ":title:`PDF` ファイルを結合するには、以下の手順を実行してください：" + +#: ../../the-basics.rst:314 aa8b57baed404805a8f27216a8bad943 +msgid "Merging :title:`PDF` files with other types of file" +msgstr ":title:`PDF` ァイルと他の種類のファイルを結合する" + +#: ../../the-basics.rst:316 01e1f212404046beb632adbff6951d69 +msgid "" +"With :meth:`Document.insert_file` you can invoke the method to merge " +":ref:`supported files` with :title:`PDF`. For " +"example:" +msgstr ":meth:`Document.insert_file` を使用すると、サポートされているファイルをPDFと結合するメソッドを呼び出すことができます。例えば：" + +#: ../../the-basics.rst:338 4a86c2a681474300aece08091d2aec60 +msgid "" +"It is easy to join PDFs with :meth:`Document.insert_pdf` & " +":meth:`Document.insert_file`. Given open :title:`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. This Wiki `article " +"`_ contains a full description." +msgstr ":meth:`Document.insert_pdf` と :meth:`Document.insert_file` を使用すれば、PDFを簡単に結合できます。開かれたPDF文書がある場合、片方のPDFから別のPDFへページの範囲をコピーすることができます。コピーされたページが配置される位置を選択することができ、ページの順序を元に戻すこともできます。さらに、ページの回転も変更することができます。詳細な説明はこの `Wiki `_ の記事に記載されています。" + +#: ../../the-basics.rst:340 baf4c632dfc84c3bb4e78b24173dff4e +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:347 49aaf7f83167419f9f64728ccc7254ae +msgid ":meth:`Document.insert_pdf`" +msgstr "" + +#: ../../the-basics.rst:348 3c4f48c5d0a341f09dbb17961c100681 +msgid ":meth:`Document.insert_file`" +msgstr "" + +#: ../../the-basics.rst:357 05c05ae370574b24b4efc4b6320db5f0 +msgid "Adding a watermark to a :title:`PDF`" +msgstr ":title:`PDF` ファイルにウォータマークを追加する方法" + +#: ../../the-basics.rst:359 da2ab9b94f8048dfb0d037c3abd1690f +msgid "To add a watermark to a :title:`PDF` file, do the following:" +msgstr ":title:`PDF` ファイルにウォータマークを追加するには、以下の手順を実行してください:" + +#: ../../the-basics.rst:383 28997c1a1b6a49ab96b762d794927fc6 +msgid "" +"Adding watermarks is essentially as simple as adding an image at the base" +" of each :title:`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:385 3da3a9427a624d61986b6158f655dc6d +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 implemetation." +msgstr "前述の例では、各ファイル参照から新しい画像が作成されていますが、メモリとファイルサイズを節約するために、この画像データは1回だけ参照されるようにすると、パフォーマンスが向上します - Page.insert_image()のコード例と説明を参照してください。" + +#: ../../the-basics.rst:389 de7dfefe24eb4f2d9ad8c989ca91d245 +msgid ":meth:`Page.bound`" +msgstr "" + +#: ../../the-basics.rst:390 ../../the-basics.rst:430 +#: 473faf7549f243bcb5e937ad06209147 64b5253bfdba42058ba70760a77d8e07 +msgid ":meth:`Page.insert_image`" +msgstr "" + +#: ../../the-basics.rst:399 1f53c91ebbfc478ca922cf5e5ed9284d +msgid "Adding an image to a :title:`PDF`" +msgstr ":title:`PDF` に画像を追加する" + +#: ../../the-basics.rst:401 b495a187f905411daae5a320b5c3506d +msgid "" +"To add an image to a :title:`PDF` file, for example a logo, do the " +"following:" +msgstr "PDFファイルに画像を追加するためには、例えばロゴを追加する場合、以下の手順を実行してください：" + +#: ../../the-basics.rst:425 99b51742be9a4371a3a8cb60e87883c5 +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:429 6f6a9c81b21f4ade9e231b79e54acbe1 +msgid ":ref:`Rect`" +msgstr "" + +#: ../../the-basics.rst:439 5efa7b8825164dc38a327c3c56bde91b +msgid "Rotating a :title:`PDF`" +msgstr ":title:`PDF` を回転させる" + +#: ../../the-basics.rst:441 f433eb4dd11f4eb197c10eed069c8ba9 +msgid "To add a rotation to a page, do the following:" +msgstr "ページに回転を追加するには、以下の手順を実行してください：" + +#: ../../the-basics.rst:461 13db8226e1bd40faab462c8540cac277 +msgid ":meth:`Page.set_rotation`" +msgstr "" + +#: ../../the-basics.rst:469 887faf4992eb4ac6be534fdb861a359c +msgid "Cropping a :title:`PDF`" +msgstr ":title:`PDF` のトリミング" + +#: ../../the-basics.rst:471 089f109aedf0406b9438fb22809ad70f +msgid "To crop a page to a defined :ref:`Rect`, do the following:" +msgstr "定義された矩形 :ref:`Rect` にページをトリミングするには、以下の手順を実行してください：" + +#: ../../the-basics.rst:491 76565215447049f197b278307ac2a6a4 +msgid ":meth:`Page.set_cropbox`" +msgstr "" + +#: ../../the-basics.rst:500 62fb5b3e95444514a66b3b808a9f93c5 +msgid ":index:`Attaching Files `" +msgstr ":index:`ファイルの添付 `" + +#: ../../the-basics.rst:502 83dca5da233848f990e1864368d7831b +msgid "To attach another file to a page, do the following:" +msgstr "別のファイルをページに添付するには、以下の手順を実行してください：" + +#: ../../the-basics.rst:528 b7ec891c77aa453aaee9c524b44f188d +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:530 0abc0e6ad8e049af9adf9268df54c95c +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:534 459f605299fc4ca294e9180ff3698542 +msgid ":ref:`Point`" +msgstr "" + +#: ../../the-basics.rst:535 ../../the-basics.rst:578 +#: 616c76e808d64713a6436d2f8ac8da97 a04686521b674e11a8d1966d6fb1f7b6 +msgid ":meth:`Document.tobytes`" +msgstr "" + +#: ../../the-basics.rst:536 19954cbe4db04f999fc450278a1c64af +msgid ":meth:`Page.add_file_annot`" +msgstr "" + +#: ../../the-basics.rst:545 d4616ab7c63141c693b9211e03126f4b +msgid ":index:`Embedding Files `" +msgstr ":index:`ファイルを埋め込む `" + +#: ../../the-basics.rst:547 10159635926b4152b8637cdbf7b193d0 +msgid "To embed a file to a document, do the following:" +msgstr "ファイルを文書に埋め込むには、以下の手順を実行してください：" + +#: ../../the-basics.rst:574 aa50d06a58b147f284ec4344e2fff179 +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:579 7c5c6a7187db42a0a4f334e18693fee8 +msgid ":meth:`Document.embfile_add`" +msgstr "" + +#: ../../the-basics.rst:589 b0db8f740144491386eb6b5e12078ab2 +msgid "Deleting Pages" +msgstr "ページを削除する" + +#: ../../the-basics.rst:591 9815575fb37448919ec75aed81ef531b +msgid "To delete a page from a document, do the following:" +msgstr "文書からページを削除するには、以下の手順を実行してください：" + +#: ../../the-basics.rst:607 b2f24cdaacdb4845accc7d03d2707636 +msgid "To delete a multiple pages from a document, do the following:" +msgstr "複数のページを文書から削除するには、以下の手順を実行してください：" + +#: ../../the-basics.rst:627 14409e67678e4ff5884840455f469f14 +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:629 bbd494027615443b9f1b0e80a9d6f38b +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:634 5dfc60edad6a49a7b37adb49243a0de6 +msgid ":meth:`Document.delete_page`" +msgstr "" + +#: ../../the-basics.rst:635 6020d5b19719485892b7822fa0e1687c +msgid ":meth:`Document.delete_pages`" +msgstr "" + +#: ../../the-basics.rst:643 39809ad29fa64948af69226067e1146c +msgid "Re-Arranging Pages" +msgstr "ページを再配置する" + +#: ../../the-basics.rst:645 0c930f04b64d4a7db94319c66b5190b3 +msgid "To re-arrange pages, do the following:" +msgstr "ページを再配置するには、以下の手順を実行してください：" + +#: ../../the-basics.rst:663 c75ad1d8e938415e8e99d4213bd38913 +msgid ":meth:`Document.move_page`" +msgstr "" + +#: ../../the-basics.rst:672 3080d333a2ba4a5cbb1db19df1200670 +msgid "Copying Pages" +msgstr "ページをコピーする" + +#: ../../the-basics.rst:675 ca76ae61162b4e81a1dc15ec5e38a915 +msgid "To copy pages, do the following:" +msgstr "ページをコピーするには、以下の手順を実行してください：" + +#: ../../the-basics.rst:694 228dae95cd334b84be75b857e61f4abe +msgid ":meth:`Document.copy_page`" +msgstr "" + +#: ../../the-basics.rst:702 c7946e7b5ef24984808db236db39fbb9 +msgid "Selecting Pages" +msgstr "ページを選択する" + +#: ../../the-basics.rst:705 e780f0c4ccd34798ac8fe6d7db17daaa +msgid "To select pages, do the following:" +msgstr "ページを選択するには、以下の手順を実行してください：" + +#: ../../the-basics.rst:723 60cc1c38015045f4b4f0b53e17d1bda8 +msgid "" +"With :title:`PyMuPDF` you have all options to copy, move, delete or re-" +"arrange the pages of a :title:`PDF`. Intuitive methods exist that allow " +"you to do this on a page-by-page level, like the " +":meth:`Document.copy_page` method." +msgstr ":title:`PyMuPDF` を使用すると、 :title:`PDF` のページをコピー、移動、削除、または再配置するためのオプションがすべて揃っています。 :meth:`Document.copy_page` メソッドのように、ページ単位で直感的なメソッドを使用してこれらの操作を行うことができます。" + +#: ../../the-basics.rst:725 48a1df1f1a3c4af1a4df1ff866d7e67b +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:736 ea46bd8ef4c94b0b9437b84acf3d821f +msgid "" +"Now let's prepare a PDF for double-sided printing (on a printer not " +"directly supporting this):" +msgstr "以下のように、両面印刷用にPDFを準備しましょう（直接これをサポートしていないプリンターで）：" + +#: ../../the-basics.rst:738 3ca4ffcb29684234b5d2de76aa3c1354 +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:750 aa0d215387254ef7b084782c59751bc5 +msgid "" +"This snippet creates the respective sub documents which can then be used " +"to print the document:" +msgstr "このスニペットは、それぞれのサブドキュメントを作成し、それらを使用してドキュメントを印刷することができます：" + +#: ../../the-basics.rst:765 451577d634524ec6ad4298a1e9fd4431 +msgid "" +"For more information also have a look at this Wiki `article " +"`_." +msgstr "詳細については、この `ウィキの記事 `_ もご覧ください。" + +#: ../../the-basics.rst:768 04e364a32ac04069b185eb329a7bd53d +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:781 3094c9253acf4a979bc46fbd94d6d51d +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:796 3d5aaf2dbb5f4a1fa26b0354aa6f822e +msgid ":meth:`Document.select`" +msgstr "" + +#: ../../the-basics.rst:807 6bb5c33bcd7c42c7b917b34802e9fd73 +msgid "Adding Blank Pages" +msgstr "空白のページを追加する" + +#: ../../the-basics.rst:809 555f310e73c24de0baccc5093d288eaa +msgid "To add a blank page, do the following:" +msgstr "空白のページを追加するには、以下の手順を行います：" + +#: ../../the-basics.rst:829 b1b69a0332694a8cb02bcbac9700e18d +msgid "Use this to create the page with another pre-defined paper format:" +msgstr "以下の方法を使用して、別の事前定義された用紙フォーマットを使ってページを作成します：" + +#: ../../the-basics.rst:839 03e24b13dc04416ebef5e11c3d7820fc +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:841 da990b02a3884629ab9193d00ae050df +msgid "" +"Here is a 3-liner that creates a :title:`PDF`: with one empty page. Its " +"file size is 460 bytes:" +msgstr "以下は、1ページの空白の :title:`PDF`: を作成するための3行のコードです。ファイルサイズは460バイトです。" + +#: ../../the-basics.rst:855 be599ce115354122bcf7fdbdebad93c5 +msgid ":meth:`Document.new_page`" +msgstr "" + +#: ../../the-basics.rst:856 3f456cb4607043529fa1f4b5d8507c60 +msgid ":attr:`paperSizes`" +msgstr "" + +#: ../../the-basics.rst:865 346a8273a0b441068bca8b04adb299f8 +msgid "Inserting Pages with Text Content" +msgstr "ページにテキストコンテンツを挿入する" + +#: ../../the-basics.rst:867 1c804e79a3f6492b8c2cec0e75b32e6a +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:893 a075a9b2dc054eefa99a6f053fb9991f +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:897 2362105fdb314ddaae2f2a32795bbfc6 +msgid ":meth:`Document.insert_page`" +msgstr "" + +#: ../../the-basics.rst:908 ed99048089a34b7cab26186d99bcab9b +msgid "Splitting Single Pages" +msgstr "単一のページを分割する" + +#: ../../the-basics.rst:910 03ab24c2dc1641deaefedf14762d35a4 +msgid "" +"This deals with splitting up pages of a :title:`PDF` in arbitrary pieces." +" For example, you may have a :title:`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 :title:`PDF` page in" +" *Letter* format again." +msgstr "この方法は、 :title:`PDF` のページを任意の部分に分割することに関連しています。例えば、Letterフォーマットのページを含む :title:`PDF` を、4倍の拡大率で印刷したい場合を考えてみましょう。各ページは4つの部分に分割され、それぞれが再びLetterフォーマットの個別の :title:`PDF` ページになります。" + +#: ../../the-basics.rst:957 ../../the-basics.rst:1018 +#: 6fc9d524abda4cb58e92940b04ea6245 c39653cceafe4550a24b7d6ea584509b +msgid "Example:" +msgstr "" + +#: ../../the-basics.rst:965 ../../the-basics.rst:1027 +#: 3d211a1843b74b9b92eff826952066bd 71cd186873074b81a83c15b5fe0d7c62 +msgid ":meth:`Page.cropbox_position`" +msgstr "" + +#: ../../the-basics.rst:966 ../../the-basics.rst:1028 +#: cd1b5f82fffd40aabdeacf2ddbf9d2cd cf24a1da34e046abafd4ef2fc8e35a77 +msgid ":meth:`Page.show_pdf_page`" +msgstr "" + +#: ../../the-basics.rst:976 33d3b20700bb4e2aa2b4a45e1d0c85da +msgid "Combining Single Pages" +msgstr "単一のページを結合する" + +#: ../../the-basics.rst:978 ae7ee4e63672493bbe792b368af04fa4 +msgid "" +"This deals with joining :title:`PDF` pages to form a new :title:`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つの元のページを組み合わせた新しい :title:`PDF` を作成することを意味します（または「2-up」、「4-up」などとも呼ばれます）。これは、ブックレットやサムネイルのような概要を作成するために使用できます。" + +#: ../../the-basics.rst:1037 9c33bb0bc0c743fe84d0d2453e85effc +msgid ":title:`PDF` Encryption & Decryption" +msgstr ":title:`PDF` の暗号化と復号化" + +#: ../../the-basics.rst:1040 6f286407eaf647e990615a24c71e32d4 +msgid "" +"Starting with version 1.16.0, :title:`PDF` decryption and encryption " +"(using passwords) are fully supported. You can do the following:" +msgstr "バージョン1.16.0から、PDFの暗号化と復号化（パスワードを使用）が完全にサポートされています。以下のことができます：" + +#: ../../the-basics.rst:1042 c0ec8e4870dd4f9d938552057e9d7680 +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:1043 b718aebed5a24a348e4dbbb2843dfd4d +msgid "Gain access authorization to a document (:meth:`Document.authenticate`)." +msgstr "ドキュメントへのアクセス権を取得する（:meth:`Document.authenticate`）。" + +#: ../../the-basics.rst:1044 0bde2bf9878b4ba7900d6d2bd9c86b5d +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:1046 0edc0fc561c640b4a3c45965529a2ffb +msgid "decrypt or encrypt the content" +msgstr "内容の復号化または暗号化" + +#: ../../the-basics.rst:1047 a749162bcc344bed86221a109d7de4d5 +msgid "set password(s)" +msgstr "パスワードの設定" + +#: ../../the-basics.rst:1048 f5c17a2227944ecd9b2be4868f21ae71 +msgid "set the encryption method" +msgstr "暗号化方式の設定" + +#: ../../the-basics.rst:1049 8aa24789673240b8a088fa8374868df7 +msgid "set permission details" +msgstr "権限の詳細設定" + +#: ../../the-basics.rst:1051 15937adee3da4606a96846915609d5c2 +msgid "A PDF document may have two different passwords:" +msgstr "PDF文書には2つの異なるパスワードが存在する場合があります：" + +#: ../../the-basics.rst:1053 32b9f73bdbaa401381001102cd827cf7 +msgid "" +"The **owner password** provides full access rights, including changing " +"passwords, encryption method, or permission detail." +msgstr "オーナーパスワード：パスワードを変更したり、暗号化方法を変更したり、権限の詳細を含む完全なアクセス権を提供します。" + +#: ../../the-basics.rst:1054 ae3b598b634148939fd99fb35a1210cc +msgid "" +"The **user password** provides access to document content according to " +"the established permission details. If present, opening the :title:`PDF` " +"in a viewer will require providing it." +msgstr "ユーザーパスワード：文書の内容にアクセスするための権限詳細に基づいてアクセスを提供します。存在する場合、ビューアでPDFを開く際にユーザーパスワードを入力する必要があります。" + +#: ../../the-basics.rst:1056 6de343f3441b4503a05d662819fafa99 +msgid "" +"Method :meth:`Document.authenticate` will automatically establish access " +"rights according to the password used." +msgstr "メソッド :meth:`Document.authenticate` は、使用されるパスワードに基づいて自動的にアクセス権を確立します。" + +#: ../../the-basics.rst:1058 738984d97f074c408e92fa48b729473f +msgid "" +"The following snippet creates a new :title:`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 "以下のスニペットは新しい :title:`PDF` を作成し、別々のユーザーパスワードとオーナーパスワードで暗号化します。印刷、コピー、注釈付けの権限が与えられますが、ユーザーパスワードで認証するユーザーに対しては変更は許可されません" + +#: ../../the-basics.rst:1095 7db02612da37440882bc23088133de4a +msgid "" +"Opening this document with some viewer (Nitro Reader 5) reflects these " +"settings:" +msgstr "このドキュメントをいくつかのビューア（Nitro Reader 5など）で開くと、これらの設定が反映されます：" + +#: ../../the-basics.rst:1099 c347565588464a8f82e45e40c5dc4cd7 +msgid "" +"**Decrypting** will automatically happen on save as before when no " +"encryption parameters are provided." +msgstr "暗号化パラメータが提供されていない場合、保存時に自動的に復号化されます。" + +#: ../../the-basics.rst:1101 e25cf33912114d1c890b740d5bcc84a2 +msgid "" +"To **keep the encryption method** of a PDF save it using " +"`encryption=fitz.PDF_ENCRYPT_KEEP`. If `doc.can_save_incrementally() == " +"True`, an incremental save is also possible." +msgstr "PDFの暗号化方法を保持するには、`encryption=fitz.PDF_ENCRYPT_KEEP` を使用して保存します。また、 `doc.can_save_incrementally() == True` であれば、増分保存も可能です" + +#: ../../the-basics.rst:1103 d52b14c170ec42138e80e202cfa2ffd6 +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:1107 73f172b102a9484a8ec268c4c76f2f95 +msgid ":meth:`Document.save`" +msgstr "" + +#: ../../footer.rst:-1 62ae625b28da426b9322011120d520e7 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/tools.mo b/docs/locales/ja/LC_MESSAGES/tools.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/tools.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/tools.po b/docs/locales/ja/LC_MESSAGES/tools.po new file mode 100644 index 000000000..dbf0626c5 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/tools.po @@ -0,0 +1,668 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../tools.rst:6 aafee9471e6d4461b7f679a35656b3e0 +msgid "Tools" +msgstr "" + +#: ../../tools.rst:8 80bbb368dac64371862412d0afdbdefd +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 "" + +#: ../../tools.rst:11 5913f097c9f947c7a18febc3df6e747e +msgid "**Method / Attribute**" +msgstr "" + +#: ../../tools.rst:11 448ef356f2d148d2a220f8d7a676b519 +msgid "**Description**" +msgstr "" + +#: ../../tools.rst:13 c7f4714d272c4e6799487a39fed60eb7 +msgid ":meth:`Tools.gen_id`" +msgstr "" + +#: ../../tools.rst:13 c8de562517474862ac67ecda8cba2235 +msgid "generate a unique identifyer" +msgstr "" + +#: ../../tools.rst:14 02be6dbc3d4546ae8763ae5aa5a44b63 +msgid ":meth:`Tools.store_shrink`" +msgstr "" + +#: ../../tools.rst:14 bb4eeeabcee048619daa2d4d4384c2d1 +msgid "shrink the storables cache [#f1]_" +msgstr "" + +#: ../../tools.rst:15 38273610bfd1474fbb62119778f5411d +msgid ":meth:`Tools.mupdf_warnings`" +msgstr "" + +#: ../../tools.rst:15 ../../tools.rst:16 814c23068b4546c99c8be46d21a2137d +#: 8c64d0da59024b6bbcaba5047b5f61be +msgid "return the accumulated MuPDF warnings" +msgstr "" + +#: ../../tools.rst:16 9c04e67764aa4c008b845ac3b1468d74 +msgid ":meth:`Tools.mupdf_display_errors`" +msgstr "" + +#: ../../tools.rst:17 a1bcdae69e0b447db10e662f547c58d8 +msgid ":meth:`Tools.reset_mupdf_warnings`" +msgstr "" + +#: ../../tools.rst:17 367e301d5f03418aaba29a21836f03df +msgid "empty MuPDF messages on STDOUT" +msgstr "" + +#: ../../tools.rst:18 e1b47a85b08d4649bc151ac24e361909 +msgid ":meth:`Tools.set_aa_level`" +msgstr "" + +#: ../../tools.rst:18 b63b08ca10ac4621a776cf2e0f6ffa1f +msgid "set the anti-aliasing values" +msgstr "" + +#: ../../tools.rst:19 7bd57f2f5d0b437a95727e03e953a68e +msgid ":meth:`Tools.set_annot_stem`" +msgstr "" + +#: ../../tools.rst:19 e718c48e9b144176baf439ad851440d6 +msgid "set the prefix of new annotation / link ids" +msgstr "" + +#: ../../tools.rst:20 599b8ec00d394550b8bef7a4fe7d5336 +msgid ":meth:`Tools.set_small_glyph_heights`" +msgstr "" + +#: ../../tools.rst:20 329637148adf4ec3835ccc596edd2105 +msgid "search and extract using small bbox heights" +msgstr "" + +#: ../../tools.rst:21 518e53f65b954d649c2978301ed8ac7a +msgid ":meth:`Tools.set_subset_fontnames`" +msgstr "" + +#: ../../tools.rst:21 77211a51910c41f1846ed97ddebdd0b0 +msgid "control suppression of subset fontname tags" +msgstr "" + +#: ../../tools.rst:22 8fda197af31c45efbf0fddba6add74ab +msgid ":meth:`Tools.show_aa_level`" +msgstr "" + +#: ../../tools.rst:22 f701230f2b4a49d38010ff6abbfdc7c9 +msgid "return the anti-aliasing values" +msgstr "" + +#: ../../tools.rst:23 2c7b574fc7124020a7dda7586f90389f +msgid ":meth:`Tools.unset_quad_corrections`" +msgstr "" + +#: ../../tools.rst:23 67a688a0d1ad4a39a667ee44b6d02764 +msgid "disable PyMuPDF-specific code" +msgstr "" + +#: ../../tools.rst:24 6e21bf9fd7b54d8d818370272d1d4efa +msgid ":attr:`Tools.fitz_config`" +msgstr "" + +#: ../../tools.rst:24 375ea3a03e74454ebcf6369dd98074d9 +msgid "configuration settings of PyMuPDF" +msgstr "" + +#: ../../tools.rst:25 9e5e356edaac4bcb93acc72e3e6e3af5 +msgid ":attr:`Tools.store_maxsize`" +msgstr "" + +#: ../../tools.rst:25 44024f5f46e54220b22b6077a770eefd +msgid "maximum storables cache size" +msgstr "" + +#: ../../tools.rst:26 d56855b9c7f849dcb184e3724174ea2b +msgid ":attr:`Tools.store_size`" +msgstr "" + +#: ../../tools.rst:26 bd09fa95315547938760f30d650b2102 +msgid "current storables cache size" +msgstr "" + +#: ../../tools.rst:29 a7dd73caec8b489997cb27d73cf6fed9 +msgid "**Class API**" +msgstr "" + +#: ../../tools.rst:35 8898e16993e84dbb817f5954e5282da9 +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 "" + +#: ../../tools.rst:37 d8d574c40699414f8619727a62a71842 +msgid "" +"MuPDF has dropped support for this in v1.14.0, so we have re-implemented " +"a similar function with the following differences:" +msgstr "" + +#: ../../tools.rst:39 fe5c810d95544dc4b9dc1ee23706f36f +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 "" + +#: ../../tools.rst:40 2ffe5c34966742939428171ad6f3b866 +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 "" + +#: ../../tools.rst 058340d2ce6f4102a361be19152b11f9 +#: 2b10632f00f9423eabed68b6c6269846 312fffe12a0040248d38d0919b789d6c +#: 977d0fb432714f2b86faf713e98d30d1 a643682b53c6471fa95cca94c4aea13a +#: a83e6f34025d4121adc09f2ff944be70 aadd2e6079ff40b1876277dcebcc7d2e +#: b63e621f38044dc5a9f61f898a14d17d d5805075d75a4af28126408491ba5ce6 +#: fffedf25e75c404cb732838242083e14 +msgid "Return type" +msgstr "" + +#: ../../tools.rst 15e24c44574d482b87a8ea01a4120104 +#: 218c633cbb374b2aad3b4b3bea5ef091 3cca765a88a841dba127485850eb8208 +#: 4a203ce0e6d54b79854db421fc778f48 56fecaf6c3a44467904d5e9e9935d75e +#: 5e598e7d3db04b6ba4cc79916f9a6250 9246bb61b3f448c0b06f1457043deb94 +#: cea469ae7c164dfdbfe9ca51c301dcc6 +msgid "Returns" +msgstr "" + +#: ../../tools.rst:43 2533660ef2754773bf9c6cd2c02e2a26 +msgid "a unique positive integer." +msgstr "" + +#: ../../tools.rst:48 2bfd870988db44629734e021da829c34 +msgid "New in v1.18.6" +msgstr "" + +#: ../../tools.rst:50 838eec22085d4c929b6fb21937addd99 +msgid "Set or inquire the prefix for the id of new annotations, fields or links." +msgstr "" + +#: ../../tools.rst 07351788adc748758c701dfca32c1132 +#: 3c37433234494747b65a100ede24a9de 468f3692d44b4551a237861aa09326fa +#: 4ab27d241ddf4e769b6cb6560e566d3d 8a533be356d84316bf454dee1414acf3 +#: b0996f6a5a0b4d68974b928b78df7d19 bf8068834bc04aafa3d97c6ae8fb3f6a +#: bfc2ff2b473b4ebe9f62cd218eae42fe +msgid "Parameters" +msgstr "" + +#: ../../tools.rst:52 689b84f6df024ea697313ab2ee4b05c4 +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 "" + +#: ../../tools.rst:55 81897eabf4ce40f1bd35089e68beed55 +msgid "the current value." +msgstr "" + +#: ../../tools.rst:60 fcdf96f9bb434f83a7f72cecb727b848 +msgid "New in v1.18.5" +msgstr "" + +#: ../../tools.rst:62 52f115056ed44e48b7935c0aec6d094b +msgid "" +"Set or inquire reduced bbox heights in text extract and text search " +"methods." +msgstr "" + +#: ../../tools.rst:64 5ef9ca425f414cbeaabfb3ffc8cdaadc +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 "" + +#: ../../tools.rst:67 ../../tools.rst:80 ../../tools.rst:94 +#: 504287800454452da74cf2bd63453ebc bbe792269a26480dbb87ec8fdc2ccabb +#: f0c58b3bc6dd49538ea802e0d8267a9a +msgid "*True* or *False*." +msgstr "" + +#: ../../tools.rst:69 edfbff1d0e624c00a533f8aef492b697 +msgid "" +"Text extraction options \"xml\", \"xhtml\" and \"html\", which directly " +"wrap MuPDF code, are not influenced by this." +msgstr "" + +#: ../../tools.rst:73 86045a55f5844c7bbad090d3fa6e0aa9 +msgid "New in v1.18.9" +msgstr "" + +#: ../../tools.rst:75 eab6558826434351b5127f0d3ac36cdc +msgid "Control suppression of subset fontname tags in text extractions." +msgstr "" + +#: ../../tools.rst:77 1e920d3eb6014bfc9b124aa21b622da8 +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 "" + +#: ../../tools.rst:82 0b277d992b90492b82dcd95d7ad96199 +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 "" + +#: ../../tools.rst:87 7e1c81fa5fd4429892917828c0dd9ef6 +msgid "New in v1.18.10" +msgstr "" + +#: ../../tools.rst:89 f97cd71622ab4843a44791edfad88b3e +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 "" + +#: ../../tools.rst:91 c41d6554df0b409f94d3d96a7bfafe23 +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 "" + +#: ../../tools.rst:99 30603186d6514a859a8451394797ca44 +msgid "Reduce the storables cache by a percentage of its current size." +msgstr "" + +#: ../../tools.rst:101 79371feb6fba451e9354df6fdaeb27cc +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 "" + +#: ../../tools.rst:104 4a39101b4d4147f7973d2e14c702886d +msgid "" +"the new current store size. Depending on the situation, the size " +"reduction may be larger than the requested percentage." +msgstr "" + +#: ../../tools.rst:108 ../../tools.rst:118 0c45beb9e8ad485cba52b98ec4f16870 +#: 1a1ba4d5facf4462a91f76096e8a34c5 +msgid "New in version 1.16.14" +msgstr "" + +#: ../../tools.rst:110 01471463b00a4528b6b0262e71b00358 +msgid "" +"Return the current anti-aliasing values. These values control the " +"rendering quality of graphics and text elements." +msgstr "" + +#: ../../tools.rst:113 397794f38edb4752af0752618f3e956b +msgid "" +"A dictionary with the following initial content: `{'graphics': 8, 'text':" +" 8, 'graphics_min_line_width': 0.0}`." +msgstr "" + +#: ../../tools.rst:120 6178ad7652d14b309c27df0d4b874b17 +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 "" + +#: ../../tools.rst:122 d084ae710ced42a8b8bb50c642dc6354 +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 "" + +#: ../../tools.rst:127 ../../tools.rst:145 1e9b5b90ac7943179d3a829a16a75f6f +#: 9471b0980a664a81aeb248ff54bd8353 +msgid "New in version 1.16.0" +msgstr "" + +#: ../../tools.rst:129 0d5732d1b00940e8ade05e2cc35089ea +msgid "Empty MuPDF warnings message buffer." +msgstr "" + +#: ../../tools.rst:134 b35a5554f4524a5b93e1a2f8795e8848 +msgid "New in version 1.16.8" +msgstr "" + +#: ../../tools.rst:136 021eede865cc4986bd37f9d0adb67be3 +msgid "Show or set whether MuPDF errors should be displayed." +msgstr "" + +#: ../../tools.rst:138 b61f47f56e264d3b932330c8a7e3e76c +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 "" + +#: ../../tools.rst:140 3e3c0073d4b5469a99236af6d26f3889 +msgid "*True* or *False*" +msgstr "" + +#: ../../tools.rst:147 505ac255b97f4611be72e5ab73af75fd +msgid "" +"Return all stored MuPDF messages as a string with interspersed line-" +"breaks." +msgstr "" + +#: ../../tools.rst:149 bd788686e8164df285950ae814076ff3 +msgid "*(new in version 1.16.7)* whether to automatically empty the store." +msgstr "" + +#: ../../tools.rst:154 ed289a2fed464e529d485fc8d5da80a6 +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 "" + +#: ../../tools.rst:157 2f10702bf5724fc78baa9e618fed9f1e +msgid "**Key**" +msgstr "" + +#: ../../tools.rst:157 3893e2a62ee441ccb245e484f046ae6d +msgid "**Support included for ...**" +msgstr "" + +#: ../../tools.rst:159 b89b19248d504b06afd72fc84e45cbb9 +msgid "plotter-g" +msgstr "" + +#: ../../tools.rst:159 c8ffd8b690874a5ab6f656de44e74f44 +msgid "Gray colorspace rendering" +msgstr "" + +#: ../../tools.rst:160 5fb63af2d2d046a78d6afdc621389ec2 +msgid "plotter-rgb" +msgstr "" + +#: ../../tools.rst:160 bced5c07d7b34720a72a8af996de4193 +msgid "RGB colorspace rendering" +msgstr "" + +#: ../../tools.rst:161 0da7ca3cc6534f84ae3b5296c0f6f748 +msgid "plotter-cmyk" +msgstr "" + +#: ../../tools.rst:161 db10acf4acdf443bbedc80d392a409d1 +msgid "CMYK colorspcae rendering" +msgstr "" + +#: ../../tools.rst:162 e5955aafbadf471fb301d8290c095b5b +msgid "plotter-n" +msgstr "" + +#: ../../tools.rst:162 9e7aaafa7ec8456bbe9f858ba7879dc4 +msgid "overprint rendering" +msgstr "" + +#: ../../tools.rst:163 2fde036029b449a49cb5f6d53c4f03ed +msgid "pdf" +msgstr "" + +#: ../../tools.rst:163 4a73e336b2894aea9be61aa8a66b3fb0 +msgid "PDF documents" +msgstr "" + +#: ../../tools.rst:164 83f64d3d5fe34d8aa4fd81a6c703e97c +msgid "xps" +msgstr "" + +#: ../../tools.rst:164 30feb1a6179845d499b48b256d58a983 +msgid "XPS documents" +msgstr "" + +#: ../../tools.rst:165 a4ededb4a8794e87b4e0d9c4deeed86e +msgid "svg" +msgstr "" + +#: ../../tools.rst:165 20cd76dceef04405a40f6ad9de9e6fe6 +msgid "SVG documents" +msgstr "" + +#: ../../tools.rst:166 772b6101e13d4b42804a66fcb565ae05 +msgid "cbz" +msgstr "" + +#: ../../tools.rst:166 c293a4c1b59a49feac7b9ac11c46fcae +msgid "CBZ documents" +msgstr "" + +#: ../../tools.rst:167 232f888112a84a5f9138c1bbb83fb63d +msgid "img" +msgstr "" + +#: ../../tools.rst:167 da01dceb61254020ac57920b005d36ce +msgid "IMG documents" +msgstr "" + +#: ../../tools.rst:168 7decc145188349a8a875677a3405b5c6 +msgid "html" +msgstr "" + +#: ../../tools.rst:168 604e91614b224157b4c6b1a38d498ad0 +msgid "HTML documents" +msgstr "" + +#: ../../tools.rst:169 3107a2c8029445f1abb6645d6d2c6f7a +msgid "epub" +msgstr "" + +#: ../../tools.rst:169 9e63f81c69244e559935d420153af835 +msgid "EPUB documents" +msgstr "" + +#: ../../tools.rst:170 aaca8eb930184742a7e30fd43ba4418d +msgid "jpx" +msgstr "" + +#: ../../tools.rst:170 1ac2442ca94a4c75a98a3c82bbdc25ed +msgid "JPEG2000 images" +msgstr "" + +#: ../../tools.rst:171 20dbac43895e4a77b4fd963b8a4a189c +msgid "js" +msgstr "" + +#: ../../tools.rst:171 3e45cf1efc6e41768f561f541be9a786 +msgid "JavaScript" +msgstr "" + +#: ../../tools.rst:172 ec84590b0c6640ceb16d92ceff57ee72 +msgid "tofu" +msgstr "" + +#: ../../tools.rst:172 fae993b7b5ab4adfb011ff27e5645bfc +msgid "all TOFU fonts" +msgstr "" + +#: ../../tools.rst:173 279d1b716e4448af8ac5a402921a4a5e +msgid "tofu-cjk" +msgstr "" + +#: ../../tools.rst:173 bc3efebed4e94349a2232b7076106b75 +msgid "CJK font subset (China, Japan, Korea)" +msgstr "" + +#: ../../tools.rst:174 ff737f1c781e47c6876c5235201d9fcd +msgid "tofu-cjk-ext" +msgstr "" + +#: ../../tools.rst:174 244785b7dc0d448fbb93083589041fd6 +msgid "CJK font extensions" +msgstr "" + +#: ../../tools.rst:175 22c8b60b49e947ac93192826fd91695e +msgid "tofu-cjk-lang" +msgstr "" + +#: ../../tools.rst:175 2be363d6849b4014808fbbb5b90ee693 +msgid "CJK font language extensions" +msgstr "" + +#: ../../tools.rst:176 b8a9251f55fe416eaae59acc32ed00c3 +msgid "tofu-emoji" +msgstr "" + +#: ../../tools.rst:176 5ad3c11c070e4ea7a7a5e5fccc361a8e +msgid "TOFU emoji fonts" +msgstr "" + +#: ../../tools.rst:177 487c16845a6744ef87de8cd8c22c802f +msgid "tofu-historic" +msgstr "" + +#: ../../tools.rst:177 3b4d6f73324446ab904bbdba65ae5ec1 +msgid "TOFU historic fonts" +msgstr "" + +#: ../../tools.rst:178 5be85ed73b9c48babffb9a86693ece38 +msgid "tofu-symbol" +msgstr "" + +#: ../../tools.rst:178 6d31597a67c44ff88543bceca8359328 +msgid "TOFU symbol fonts" +msgstr "" + +#: ../../tools.rst:179 7bc18236c47d43499135b00656a04a29 +msgid "tofu-sil" +msgstr "" + +#: ../../tools.rst:179 27036893e7744cfab75bb7b896d67315 +msgid "TOFU SIL fonts" +msgstr "" + +#: ../../tools.rst:180 88c373bdc0a84cddb0d7702614582672 +msgid "icc" +msgstr "" + +#: ../../tools.rst:180 214b972767cc441d9d64ec4464cbe66c +msgid "ICC profiles" +msgstr "" + +#: ../../tools.rst:181 2afa51a107a24bc29d6646b7c4f815bb +msgid "py-memory" +msgstr "" + +#: ../../tools.rst:181 e6e08f2f496d47109535600966bf95d6 +msgid "using Python memory management [#f2]_" +msgstr "" + +#: ../../tools.rst:182 009469dac7794f07aceb53a8b756c0e7 +msgid "base14" +msgstr "" + +#: ../../tools.rst:182 b45357d4908442378422d6c13deaa919 +msgid "Base-14 fonts (should always be true)" +msgstr "" + +#: ../../tools.rst:185 7d5938c3481248b196be94727e8b24c5 +msgid "" +"For an explanation of the term \"TOFU\" see `this Wikipedia article " +"`_.::" +msgstr "" + +#: ../../tools.rst:219 9ba33be9f44f4bee85088b110f68e380 +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 "" + +#: ../../tools.rst:225 ba9a1ea3cea247e499ef11192aa90417 +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_maxize` is going to" +" be exceeded: in this case, MuPDF will evict low-usage objects until the " +"value is again in range." +msgstr "" + +#: ../../tools.rst:230 654b9d6346d540feaa91538ed41f99f4 +msgid "Example Session" +msgstr "" + +#: ../../tools.rst:264 f975d7f2290e46918840924330e1164b +msgid "::" +msgstr "" + +#: ../../tools.rst:267 c81d367191364aa9b726d85bff96a20b +msgid "Footnotes" +msgstr "" + +#: ../../tools.rst:268 e993b91c17d8414fb7952ab83a06751d +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 fitz*), 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 "" + +#: ../../tools.rst:270 408db856dc084e94b8756f96d0f58416 +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 "" + +#: ../../footer.rst:-1 0ef7a17f5b8b490eb636449dfcabbc87 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/tutorial.mo b/docs/locales/ja/LC_MESSAGES/tutorial.mo new file mode 100644 index 000000000..093f2b0d1 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/tutorial.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/tutorial.po b/docs/locales/ja/LC_MESSAGES/tutorial.po new file mode 100644 index 000000000..4d91cd823 --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/tutorial.po @@ -0,0 +1,1079 @@ +# 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" + +#: ../../tutorial.rst:7 5c4a918625fa441db4f227a238b2d5e3 +msgid "Tutorial" +msgstr "チュートリアル" + +#: ../../tutorial.rst:11 719986736a34415595b73358ee800f14 +msgid "" +"This tutorial will show you the use of :title:`PyMuPDF`, :title:`MuPDF` " +"in :title:`Python`, step by step." +msgstr "このチュートリアルでは、PythonでのPyMuPDF、MuPDFのステップバイステップの使用方法を紹介します。" + +#: ../../tutorial.rst:13 2f8ed09d6ae540cb906d47e1258a9e40 +msgid "" +"Because :title:`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 5a69fe535dfc4c1daccd9048b7cc6b23 +msgid "Importing the Bindings" +msgstr "バインディングのインポート" + +#: ../../tutorial.rst:17 97f710703ce7496f909473dfbf304249 +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:27 24caa12f29ee41f792cc2ae6597d590e +msgid "Note on the Name *fitz*" +msgstr "*fitz* という名前についての注意事項" + +#: ../../tutorial.rst:28 9f6721a421e84ab9b77009827ef98aed +msgid "" +"The top level Python import name for this library is **\"fitz\"**. This " +"has historical reasons:" +msgstr "このライブラリのPythonのトップレベルインポート名は **"fitz"** です。 これには歴史的な理由があります：" + +#: ../../tutorial.rst:30 066578a83abe44f39ce0848cd0d90876 +msgid "The original rendering library for MuPDF was called *Libart*." +msgstr "MuPDFの元々のレンダリングライブラリは *Libart* と呼ばれていました。" + +#: ../../tutorial.rst:32 cc1ac62c6ded474a992dde3f6cb8b0cc +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:37 c2725784bf264b43b81883bd3e0ec5e9 +msgid "" +"So :title:`PyMuPDF` **cannot coexist** with packages named \"fitz\" in " +"the same Python environment." +msgstr "したがって、PyMuPDFは同じPython環境で「fitz」という名前のパッケージと共存することはできません" + +#: ../../tutorial.rst:43 75688abd38bb481bb5bdd33716ef5bb8 +msgid "Opening a Document" +msgstr "ドキュメントの開く" + +#: ../../tutorial.rst:45 8d6b755cc0ef4426b4913f3b37df2677 +msgid "" +"To access a :ref:`supported document`, it must be " +"opened with the following statement::" +msgstr ":ref:`サポートされているドキュメント ` にアクセスするには、次の文で開く必要があります::" + +#: ../../tutorial.rst:49 879bec1ccc644d52a0681375074ddf14 +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:51 39d3a2558d71453480396a912e30ddc3 +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:53 4e4faec30dd34c269046f6feab570861 +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:56 835e65bd2d494d4692f8abe694f1b987 +msgid "Some :ref:`Document` Methods and Attributes" +msgstr "いくつかの :ref:`Document` メソッドと属" + +#: ../../tutorial.rst:59 1eda4320dbf84d6c9f5bfd05b3007cb6 +msgid "**Method / Attribute**" +msgstr "**メソッド / 属性**" + +#: ../../tutorial.rst:59 8795879481af4ad49e4a7a3119a18023 +msgid "**Description**" +msgstr "説明" + +#: ../../tutorial.rst:61 d5b4ea892cce42758233431d63a97877 +msgid ":attr:`Document.page_count`" +msgstr "" + +#: ../../tutorial.rst:61 236036b4c46c49cab3a1a3d43139c4d0 +msgid "the number of pages (*int*)" +msgstr "ページ数 (*int*)" + +#: ../../tutorial.rst:62 dea038f0da9346f88be7a16f12f87d6f +msgid ":attr:`Document.metadata`" +msgstr "" + +#: ../../tutorial.rst:62 81d587812a0041a6943353e8fa83d660 +msgid "the metadata (*dict*)" +msgstr "メタデータ (*dict*)" + +#: ../../tutorial.rst:63 b471251a01e043fdb95b435bf3446430 +msgid ":meth:`Document.get_toc`" +msgstr "" + +#: ../../tutorial.rst:63 c4629463aef646fc9356d956691b4eae +msgid "get the table of contents (*list*)" +msgstr "目次を取得する (*list*)" + +#: ../../tutorial.rst:64 330d7ca0afe24de6904039bd2e6502b6 +msgid ":meth:`Document.load_page`" +msgstr "" + +#: ../../tutorial.rst:64 74b6d8be6d324449b2a432fd91cce45d +msgid "read a :ref:`Page`" +msgstr ":ref:`Page` を読む" + +#: ../../tutorial.rst:68 84980cf29bf4459688927c49094d3b0f +msgid "Accessing Meta Data" +msgstr "メタデータへのアクセス" + +#: ../../tutorial.rst:69 28c797b0daa148b48b877d8d27f13ade +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:72 de7ca7dd8a2c48068edbeb912acad7fb +msgid "Key" +msgstr "キー" + +#: ../../tutorial.rst:72 d94628cd03a14b1b9efdebfdf1f828aa +msgid "Value" +msgstr "値" + +#: ../../tutorial.rst:74 72fc727120bc41c6843220db561c7eeb +msgid "producer" +msgstr "" + +#: ../../tutorial.rst:74 abb8a290f01f44ef8fa9aa8c56bcfbd6 +msgid "producer (producing software)" +msgstr "プロデューサー（生成ソフトウェア）" + +#: ../../tutorial.rst:75 aef623f716054580ae1228dbccccf217 +msgid "format" +msgstr "" + +#: ../../tutorial.rst:75 a2de1a6bc4a241c2b917b76cc5184d89 +msgid "format: 'PDF-1.4', 'EPUB', etc." +msgstr "形式：'PDF-1.4'、'EPUB'など" + +#: ../../tutorial.rst:76 34b9516b7f3a45c999df61c961315db6 +msgid "encryption" +msgstr "" + +#: ../../tutorial.rst:76 4a775e12fcb946d7be0479971247063d +msgid "encryption method used if any" +msgstr "暗号化方法（適用されている場合）" + +#: ../../tutorial.rst:77 0b32fc24fe464ac1935c938c5f4483a2 +#: fc4e4a5dd8e547b487dd0da1f39f9950 +msgid "author" +msgstr "" + +#: ../../tutorial.rst:78 b911cb543d99448c96b3b37a944fb7e3 +msgid "modDate" +msgstr "" + +#: ../../tutorial.rst:78 0173108974294568ae2e0fa554634116 +msgid "date of last modification" +msgstr "最終更新日" + +#: ../../tutorial.rst:79 09f9f58cca07444dad122d984cb15b36 +#: 0d27d6b13a7e4418a11d84de39ad0f6e +msgid "keywords" +msgstr "" + +#: ../../tutorial.rst:80 7b1e94dae4314466a26091f5366085ef +#: bf9bfefef1ed42078676eb5c82108093 +msgid "title" +msgstr "" + +#: ../../tutorial.rst:81 b700c5e5f38c4e50b95ebeccda7e18b4 +msgid "creationDate" +msgstr "" + +#: ../../tutorial.rst:81 a827c62e8d2f4e588caffa9593aca08b +msgid "date of creation" +msgstr "作成日" + +#: ../../tutorial.rst:82 b9a5a2faee8241de926834bd8699c14f +msgid "creator" +msgstr "" + +#: ../../tutorial.rst:82 7b669ca845b94f2a8b8082c66368529b +msgid "creating application" +msgstr "作成アプリケーション" + +#: ../../tutorial.rst:83 193d31ea75f84be0b73e220c2f6fe5e4 +#: 1bbfc08453e14f33af467e7ee9dc53ab +msgid "subject" +msgstr "" + +#: ../../tutorial.rst:86 69a6449ed3f74164a9d494e3686b1e6e +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:88 6790ef2b4d9544d1b499c823d4710e13 +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:91 18397652b156491ca983c4e18d992eca +msgid "Working with Outlines" +msgstr "アウトラインと一緒に作業する" + +#: ../../tutorial.rst:92 bce0efd6dad946f184aeeba9db5ccab2 +msgid "" +"The easiest way to get all outlines (also called \"bookmarks\") of a " +"document, is by loading its *table of contents*::" +msgstr "アウトライン（または「ブックマーク」とも呼ばれる）を取得する最も簡単な方法は、そのドキュメントの目次を読み込むことです::" + +#: ../../tutorial.rst:96 922e8d6314a94c0baf21eececaa23484 +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:98 a9d1d761d8244786b2fb834eba377c42 +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:100 de626ab8d30e4db0a4824fe238a4c59e +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:103 14dd86b035e64356b4184dd735c1244a +msgid "Working with Pages" +msgstr "ページの操作" + +#: ../../tutorial.rst:104 878270fa24d0413dbe553e688199d094 +msgid ":ref:`Page` handling is at the core of MuPDF's functionality." +msgstr ":ref:`Page` の処理はMuPDFの機能の中核です。" + +#: ../../tutorial.rst:106 dfa8b2cde8894ec383a078c5799f575f +msgid "" +"You can render a page into a raster or vector (SVG) image, optionally " +"zooming, rotating, shifting or shearing it." +msgstr "ページをラスターまたはベクター（SVG）イメージにレンダリングすることができます。オプションでズーム、回転、シフト、またはシアーを行うこともできます" + +#: ../../tutorial.rst:107 20afbcd5bd8d490dbe71e30a014a4c7f +msgid "" +"You can extract a page's text and images in many formats and search for " +"text strings." +msgstr "テキストと画像を多くの形式で抽出し、テキスト文字列を検索することができます。" + +#: ../../tutorial.rst:108 a3544d9a327047fb95cbfc943edd350a +msgid "" +"For PDF documents many more methods are available to add text or images " +"to pages." +msgstr "PDFドキュメントの場合、さらに多くのメソッドが利用可能で、テキストや画像をページに追加することができます" + +#: ../../tutorial.rst:110 5ba4202e226e4adbb099e6690a2cc50f +msgid "" +"First, a :ref:`Page` must be created. This is a method of " +":ref:`Document`::" +msgstr "最初に :ref:`Page` を作成する必要があります。これは :ref:`Document` のメソッドです::" + +#: ../../tutorial.rst:115 aea327ad27534ed5bedd2bef1bf334d6 +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:117 7d87c0d2d1034c76b01d72af78200051 +msgid "" +"Some more advanced way would be using the document as an **iterator** " +"over its pages::" +msgstr "より高度な方法として、ドキュメントをそのページの **イテレータ** として使用することもできます::" + +#: ../../tutorial.rst:131 ed0d09fe18de4836938eca56fa4a71a7 +msgid "Once you have your page, here is what you would typically do with it:" +msgstr "ページを取得したら、通常は次のようなことを行います：" + +#: ../../tutorial.rst:134 4b110b01ceea44bb9b3d174a06e74fff +msgid "Inspecting the Links, Annotations or Form Fields of a Page" +msgstr "リンク、注釈、またはフォームフィールドをページで調査する" + +#: ../../tutorial.rst:135 cad7f30eddf84559aaeac6ccc3f3c678 +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:140 31ac4878f99347a6becb0bbdbfc5771a +msgid "" +"*links* is a Python list of dictionaries. For details see " +":meth:`Page.get_links`." +msgstr "`links` はPythonの辞書のリストです。詳細は :meth:`Page.get_links` を参照してください。" + +#: ../../tutorial.rst:142 326b0a8d8f5c4f82a48432aa9bd27087 +msgid "You can also use an iterator which emits one link at a time::" +msgstr "また、一度に1つのリンクを生成するイテレータを使用することもできます::" + +#: ../../tutorial.rst:147 68cc7324df514749b6af2321cefac9cc +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:157 ea4ffe181e3443e0a2102d4425a5fb11 +msgid "Rendering a Page" +msgstr "ページのレンダリング" + +#: ../../tutorial.rst:158 9d16db8d44924b679b68af5d7fa7e2b1 +msgid "This example creates a **raster** image of a page's content::" +msgstr "以下の例は、ページの内容をラスター画像として作成します::" + +#: ../../tutorial.rst:162 f9116518fbd747cfa4276003324bb4cd +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:164 4f67371c65164f04934bfffc53cf0212 +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:166 b7c15bcd90c1406ea7867a3b7352be2a +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:169 a4a12f24ea9549bfb5e424648fee2f8e +msgid "Saving the Page Image in a File" +msgstr "ページのイメージをファイルに保存する" + +#: ../../tutorial.rst:170 a81b35f1e64a4fb8b557074c332349f0 +msgid "We can simply store the image in a PNG file::" +msgstr "簡単にページのイメージをPNGファイルに保存できます::" + +#: ../../tutorial.rst:175 11f7edc0423246159b3e77ff12e9c4ee +msgid "Displaying the Image in GUIs" +msgstr "GUIでイメージを表示する" + +#: ../../tutorial.rst:176 11e725972b62427f8363406f2b7fcb73 +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:179 832f9658d8bb48cbb8b4b6a85f1380bf +msgid "wxPython" +msgstr "" + +#: ../../tutorial.rst:180 6c8fc0ded35e41bd998220410ac37eec +msgid "" +"Consult their documentation for adjustments to RGB(A) pixmaps and, " +"potentially, specifics for your wxPython release::" +msgstr "RGB(A)のピクセルマップに対する調整や、可能な場合はwxPythonのリリースに特有の詳細については、関連するドキュメントを参照してください。" + +#: ../../tutorial.rst:188 cfed92bff18a4b3689114215bf928d5c +msgid "Tkinter" +msgstr "" + +#: ../../tutorial.rst:189 61b81fd31327412b917b3a76c6e6198c +msgid "Please also see section 3.19 of the `Pillow documentation`_::" +msgstr "`Pillow documentation`_ ドキュメントのセクション3.19も参照してください。" + +#: ../../tutorial.rst:198 82cd3df69e9842fc9b9e958c619b07bb +msgid "The following **avoids using Pillow**::" +msgstr "以下の方法では、Pillowを使用しないようにしています。" + +#: ../../tutorial.rst:205 4651636cbd21450c861c18bd023463ba +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:208 80fe1c66cb934c7aaa42e3f3760ea928 +msgid "PyQt4, PyQt5, PySide" +msgstr "" + +#: ../../tutorial.rst:209 76f42a0b7f644048843acb47071e42cf +msgid "Please also see section 3.16 of the `Pillow documentation`_::" +msgstr "Pillowドキュメントのセクション3.16も参照してください。" + +#: ../../tutorial.rst:218 ac906b97455f48f3a0b19f83b59d2462 +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:228 db764b1aa9734b0986744d62812df2a3 +msgid "Extracting Text and Images" +msgstr "テキストや画像を抽出する" + +#: ../../tutorial.rst:229 f3d020fd41cf4719ad8a95ebff447cc6 +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:233 219bda27169f48aabfd1876a44eee34d +msgid "" +"Use one of the following strings for *opt* to obtain different formats " +"[#f2]_:" +msgstr "異なるフォーマットを得るために、以下の文字列のうち1つをoptに使用できます [#f2]_:" + +#: ../../tutorial.rst:235 d7fd8dffe1ba49a7bb8fa1b25cc4dfb0 +msgid "" +"**\"text\"**: (default) plain text with line breaks. No formatting, no " +"text position details, no images." +msgstr "**"text"**: (デフォルト) 行送りのプレーンテキスト。書式設定やテキストの位置の詳細、画像は含まれません。" + +#: ../../tutorial.rst:237 3147bdd9d3944998b04054dd2598f6da +msgid "**\"blocks\"**: generate a list of text blocks (= paragraphs)." +msgstr "**"blocks"**: テキストブロック（段落）のリストを生成します。" + +#: ../../tutorial.rst:239 b8d880738edc437382038c761693e7f3 +msgid "**\"words\"**: generate a list of words (strings not containing spaces)." +msgstr "**"words"**: 単語（スペースを含まない文字列）のリストを生成します。" + +#: ../../tutorial.rst:241 c705843da943450881d5a37b51499236 +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:243 a767c8f6b5434360be3064a7662f42c3 +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:245 e3d0b59782cc48a0a10ccaafed8c23bd +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:247 bf1c9316fe1f4d55a40668470ee5327c +msgid "" +"**\"xhtml\"**: text information level as the TEXT version but includes " +"images. Can also be displayed by internet browsers." +msgstr "**"xhtml"**: TEXTバージョンのテキスト情報レベルを含み、画像も含まれます。インターネットブラウザでも表示できます。" + +#: ../../tutorial.rst:249 96f75cd5e4bc4e9cb5a68904ec229da1 +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:251 01e4d79b534f463295bff2865aa792f4 +msgid "" +"To give you an idea about the output of these alternatives, we did text " +"example extracts. See :ref:`Appendix2`." +msgstr "これらの代替方法の出力のイメージを示すために、テキストの例抽出を行いました。:ref:`Appendix2` を参照してください" + +#: ../../tutorial.rst:254 36c43c7a121140708a18c892a277cd19 +msgid "Searching for Text" +msgstr "テキストを検索す" + +#: ../../tutorial.rst:255 8ac6bfa71d8347c3ab16f6a486a4b350 +msgid "You can find out, exactly where on a page a certain text string appears::" +msgstr "特定のテキスト文字列がページのどこに現れるかを正確に調べることができます。::" + +#: ../../tutorial.rst:259 e8c49733f97b465ead9ef31f11895d30 +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:261 f80648ae59784bf389a45230d65c9cb1 +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:268 72cfb8f259b043e98e2684bf39f4c778 +msgid "Stories: Generating PDF from HTML Source" +msgstr "ストーリー: HTMLソースからPDFを生成する" + +#: ../../tutorial.rst:270 7920d3f74d7947c38fb0abb4ce9ff6c4 +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:272 27046a84d8234c35b370027bf8a36d5a +msgid "" +"The following is a quote from the book `\"MuPDF Explored\"`_ by Robin " +"Watts from `Artifex`_:" +msgstr "以下はArtifexのRobin Wattsによる書籍「MuPDF Explored」からの引用です。" + +#: ../../tutorial.rst:276 00b4135f21254e93a829c508a864e81b +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:278 d48b4b64725b4be1a49e977ba6b3c0da +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:282 b26a153f07624828a7aad522a248497a +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:285 4168d93f90af462fa5b3dd8a0381f45d +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:287 7a940d3d338e45ccbaeb75318bc2c8fd +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:289 7bb6467df94d4e038318229537988b86 +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:291 7419a6680aa345c595a56527687d3cde +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:294 9fddc5925b914ab280b4b7b77109e4cc +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:296 e23adc9677b344e19505ecfdc0f56ba5 +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:298 784cd370d79e47b4b2ef0703a63edfb7 +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:300 6b175a494fa74258bfdd0329ca8606af +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:302 b5428342531747fd8e7975bdaffc75bd +msgid "" +"Please see the :ref:`Stories recipes` for a number of " +"typical use cases." +msgstr "典型的な使用例については、 :ref:`Stories recipes` レシピをご覧ください。" + +#: ../../tutorial.rst:306 484e41f2d0c64834a58b08a72e191482 +msgid "PDF Maintenance" +msgstr "PDFメンテナンス" + +#: ../../tutorial.rst:307 46372e1f0cc042aca4e82a9e5ed55833 +msgid "" +"PDFs are the only document type that can be **modified** using PyMuPDF. " +"Other file types are read-only." +msgstr "PDFはPyMuPDFを使用して変更できる唯一のドキュメントタイプです。他のファイルタイプは読み取り専用です。" + +#: ../../tutorial.rst:309 d0928871fe77487b954e3805bbeaceaa +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:311 f8d0cdbdce9842109fc4a058c536f11c +msgid "" +":meth:`Document.save()` always stores a PDF in its current (potentially " +"modified) state on disk." +msgstr ":meth:`Document.save()` は常に現在の（変更された可能性のある）PDFをディスクに保存します。" + +#: ../../tutorial.rst:313 5804c300f5d94ed594785e51939801e0 +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:315 add7d07e60bf4c749cda96eedc80eaf6 +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:318 e96581b9ba0a4347b0cc0f4427f7879c +msgid "Modifying, Creating, Re-arranging and Deleting Pages" +msgstr "ページの修正、作成、再配置、および削" + +#: ../../tutorial.rst:319 7fd2c972ece147fd8a08b7549ab0ba45 +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:321 653e97f79728420a9c6db939347feddb +msgid "" +":meth:`Document.delete_page` and :meth:`Document.delete_pages` delete " +"pages." +msgstr ":meth:`Document.delete_page` と :meth:`Document.delete_pages` はページを削除します。" + +#: ../../tutorial.rst:323 15e52460fabd4c5ea7683784ba8b2350 +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:325 b12c0df310ae4c30985edacdd35a1d92 +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:327 82e0a740bce14680b20dfc2043912329 +msgid "So you can easily create new PDFs with" +msgstr "したがって、次のような簡単な方法で新しいPDFを作成できます:" + +#: ../../tutorial.rst:329 dae5af188ea94cc6a67a77efe1136a27 +msgid "the first or last 10 pages," +msgstr "最初または最後の10ページ" + +#: ../../tutorial.rst:330 6ed35cb02b3643f2b5e03f8282a19add +msgid "only the odd or only the even pages (for doing double-sided printing)," +msgstr "奇数ページのみまたは偶数ページのみ（両面印刷用）" + +#: ../../tutorial.rst:331 2937331ad048423fa2c8912b274379d5 +msgid "pages that **do** or **don't** contain a given text," +msgstr "特定のテキストを含むまたは含まないページ" + +#: ../../tutorial.rst:332 30e9e0ab0ee946d8892dbdd3b6051f98 +msgid "reverse the page sequence, ..." +msgstr "ページの順序を逆にする" + +#: ../../tutorial.rst:334 0cc0bda6c9b5499cb0f2361f32a6a335 +msgid "... whatever you can think of." +msgstr "... など、思いつく限りのことができます。" + +#: ../../tutorial.rst:336 123af1f37a09429a958fc2589ec7e776 +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:338 17f4ced6467c46aab4732c2c0231b0c4 +msgid "" +":meth:`Document.insert_page` and :meth:`Document.new_page` insert new " +"pages." +msgstr ":meth:`Document.insert_page` および :meth:`Document.new_page` は新しいページを挿入します。" + +#: ../../tutorial.rst:340 f449527ee6704e8ca6ae9200d2981b43 +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:343 fa58c77568624babb9f8b6a06fb2509c +msgid "Joining and Splitting PDF Documents" +msgstr "PDF文書の結合と分割" + +#: ../../tutorial.rst:345 a8f201649e0c444499f6f6f7ba3fd709 +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:350 7ba283d76afc49f8b01dc9ad158f1ab8 +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:357 7f1ccad4f84d4526bab753264dcf634b +msgid "" +"More can be found in the :ref:`Document` chapter. Also have a look at " +"`PDFjoiner.py`_." +msgstr ":ref:`Document` の章にはさらに詳細が記載されています。また、 `PDFjoiner.py`_ も確認してください。" + +#: ../../tutorial.rst:360 7a52aaff2742471f80b54369a3007fcf +msgid "Embedding Data" +msgstr "データの埋め込み" + +#: ../../tutorial.rst:362 69d995329db34e3ab1fce445fe1ba175 +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:364 888dea831e6b4614925bc9a87d80c40e +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:368 34358840185f492cac2beaf89fc24545 +msgid "Saving" +msgstr "保存" + +#: ../../tutorial.rst:370 6836889445744460887fe2c25ac5f7df +msgid "" +"As mentioned above, :meth:`Document.save` will **always** save the " +"document in its current state." +msgstr "前述のように、 :meth:`Document.save` は常にドキュメントを現在の状態で保存します。" + +#: ../../tutorial.rst:372 7114c25e86c346efbed1db6d61e573f6 +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:374 b09d904cbe53494e81ddf8da17b0cb6f +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:377 efb6628317d84e87a898689c34219534 +msgid "**Save Option**" +msgstr "**保存オプション**" + +#: ../../tutorial.rst:377 34cce396c757493280868b26ff93fda7 +msgid "**mutool**" +msgstr "" + +#: ../../tutorial.rst:377 2da048010dcf4b18907873f2b9b23d63 +msgid "**Effect**" +msgstr "**効果**" + +#: ../../tutorial.rst:379 d04c4f7fe2d348649bfc9df301fb4106 +msgid "garbage=1" +msgstr "" + +#: ../../tutorial.rst:379 8cdc8a6e4c56415d8606656947bf757f +msgid "g" +msgstr "" + +#: ../../tutorial.rst:379 5ab04e89ab464c9d8ae1cf807e4bf40f +msgid "garbage collect unused objects" +msgstr "未使用のオブジェクトをガベージコレクションします" + +#: ../../tutorial.rst:380 baf6e1c997e949929acd6f06f10fd506 +msgid "garbage=2" +msgstr "" + +#: ../../tutorial.rst:380 9bbfd314b7a24e3786efd09de2133aa3 +msgid "gg" +msgstr "" + +#: ../../tutorial.rst:380 fc7eaf8bca8e4257aed1ae2aac51a40f +msgid "in addition to 1, compact :data:`xref` tables" +msgstr "1に加えて、xrefテーブルをコンパクトにします" + +#: ../../tutorial.rst:381 495c3736d28a40d38b64033697c38152 +msgid "garbage=3" +msgstr "" + +#: ../../tutorial.rst:381 64257a9d67204ee984f9e833f6f7058e +msgid "ggg" +msgstr "" + +#: ../../tutorial.rst:381 d4eef77b100a4af9b5685c4c36ea24a4 +msgid "in addition to 2, merge duplicate objects" +msgstr "2に加えて、重複したオブジェクトをマージします" + +#: ../../tutorial.rst:382 de444a775b974ff78a6180fb79b59089 +msgid "garbage=4" +msgstr "" + +#: ../../tutorial.rst:382 3e6c6505680740dc828d9502851b5e68 +msgid "gggg" +msgstr "" + +#: ../../tutorial.rst:382 0794f1c8d1ba47479b7cf12f4d610482 +msgid "in addition to 3, merge duplicate stream content" +msgstr "3に加えて、重複したストリームの内容をマージします" + +#: ../../tutorial.rst:383 1e0450ee5e004d1dbf51f02b5bc7df56 +msgid "clean=True" +msgstr "" + +#: ../../tutorial.rst:383 61d50275909f42f9b483bc5560907aaf +msgid "cs" +msgstr "" + +#: ../../tutorial.rst:383 423641572dcf475990156437a2e71ecf +msgid "clean and sanitize content streams" +msgstr "コンテンツストリームをクリーンアップしてサニタイズします" + +#: ../../tutorial.rst:384 3d8e563d8cde4ee193ed1f032ae89c05 +msgid "deflate=True" +msgstr "" + +#: ../../tutorial.rst:384 4a2b23ef1ddc4025a6320b04bdf1b665 +msgid "z" +msgstr "" + +#: ../../tutorial.rst:384 73fbc752a3314295878abe26424e34d8 +msgid "deflate uncompressed streams" +msgstr "非圧縮のストリームをdeflate圧縮します" + +#: ../../tutorial.rst:385 2e8a12be6e3a4b01ab3f2eefcdf2d3c8 +msgid "deflate_images=True" +msgstr "" + +#: ../../tutorial.rst:385 a549789436034f7d82ac9a0de9fe2e44 +msgid "i" +msgstr "" + +#: ../../tutorial.rst:385 370d3d88cce048a4b75fe05a78fc6848 +msgid "deflate image streams" +msgstr "画像ストリームをdeflate圧縮します" + +#: ../../tutorial.rst:386 c78eaa6dae3843a79f397641d6745f63 +msgid "deflate_fonts=True" +msgstr "" + +#: ../../tutorial.rst:386 162fe12711204d0591c916fcf4b69142 +msgid "f" +msgstr "" + +#: ../../tutorial.rst:386 dbd3721aef9c434ab622dc0212f86908 +msgid "deflate fontfile streams" +msgstr "フォントファイルストリームをdeflate圧縮します" + +#: ../../tutorial.rst:387 b461d640b4fe418390aba1a25f460e4d +msgid "ascii=True" +msgstr "" + +#: ../../tutorial.rst:387 f1db666528d74da2881e60b74994638c +msgid "a" +msgstr "" + +#: ../../tutorial.rst:387 d697145dd0e74c69a10bad5bbde2b6f2 +msgid "convert binary data to ASCII format" +msgstr "バイナリデータをASCII形式に変換します" + +#: ../../tutorial.rst:388 4994c587ad7a4ec9916a3976c603ded8 +msgid "linear=True" +msgstr "" + +#: ../../tutorial.rst:388 5116724085a847a6bd42158091246029 +msgid "l" +msgstr "" + +#: ../../tutorial.rst:388 bf8abaa5ebcb44358f4c63b591e40539 +msgid "create a linearized version" +msgstr "線形化バージョンを作成します" + +#: ../../tutorial.rst:389 687d7eacc4a648dd8ffb421169c0a61c +msgid "expand=True" +msgstr "" + +#: ../../tutorial.rst:389 b1763683055e4251bd00a0bd54c233dd +msgid "d" +msgstr "" + +#: ../../tutorial.rst:389 7498719539bb47238ccfd6fc4a7a296c +msgid "decompress all streams" +msgstr "すべてのストリームを解凍します" + +#: ../../tutorial.rst:392 a5c9a5db52a3489db62dc5678a5e773e +msgid "" +"For an explanation of terms like *object, stream, xref* consult the " +":ref:`Glossary` chapter." +msgstr "オブジェクト、ストリーム、xrefなどの用語の詳細については、 :ref:`Glossary` の章を参照してください。" + +#: ../../tutorial.rst:394 aa12a8dbff3e44f7bf96f84ef3363d72 +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:397 55faca7773c54e25aa39c68e348b51eb +msgid "Closing" +msgstr "クローズ" + +#: ../../tutorial.rst:398 55ef329cbc1b498cb3c1efd11e4093d7 +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:400 0c9d88aeb3ce42b48da9ffe1a8343ec3 +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:403 0467691e64fd4a6db56eaf52f3973ed1 +msgid "Further Reading" +msgstr "さらなる情報" + +#: ../../tutorial.rst:404 c4798e7fc1df447e97bee53b665c40ce +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:406 0e127d21800a4f55a77e93cd69b577a3 +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:413 57f051984fe34e16bba92889cd04e47e +msgid "Footnotes" +msgstr "脚注" + +#: ../../tutorial.rst:414 efa5a683610140379948d857195303cd +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:416 21af3dddafc94410a79c41465405c87d +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:418 a703bd8e6c0a47488323b2a7f29c9908 +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:-1 f89dcdb6d2504b5ea7fecff9fdc5ab40 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/vars.mo b/docs/locales/ja/LC_MESSAGES/vars.mo new file mode 100644 index 000000000..b4c6d23d8 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/vars.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/vars.po b/docs/locales/ja/LC_MESSAGES/vars.po new file mode 100644 index 000000000..c377ae17e --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/vars.po @@ -0,0 +1,634 @@ +# PyMuPDF Japanese documentation +# 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: 2023-08-16 14:20+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" + +#: ../../vars.rst:5 13a9c435b4fb4808aaf87a646666089e +msgid "Constants and Enumerations" +msgstr "定数と列挙型" + +#: ../../vars.rst:6 edfeee758184420e9e6d2f43ac99291d +msgid "" +"Constants and enumerations of :title:`MuPDF` as implemented by " +":title:`PyMuPDF`. Each of the following variables is accessible as " +"*fitz.variable*." +msgstr "PyMuPDFによって実装されたMuPDFの定数と列挙型。以下の各変数は、*fitz.variable*としてアクセスできます。" + +#: ../../vars.rst:10 39215ef37bcb4748b0047f693ba0b935 +msgid "Constants" +msgstr "定数" + +#: ../../vars.rst:14 3c878d3a511e4ce4a30c25085a6b74f8 +msgid "Predefined Python list of valid :ref:`Base-14-Fonts`." +msgstr "PDFベース14フォントの事前定義されたPythonリスト。" + +#: ../../vars.rst 02785071f0514a18b26e637e01c37fe0 +#: 086fc206b05d4b89a811ffefe209a9be 2a52ba2004da4fa29bb9cd77150cd9bb +#: 31467abfb6f34f72b7e8052830625785 4c52a03efb754bf5b6f1b6eec66cd172 +#: 51ee94ccca9f4a2ab5fa5ac7e9ad92ba 5a896dd4f93e42818673f37134293f68 +#: 60a484c1f1ad48ad94c4c0c9c09d05a7 6e6a34b3858d4888b9eb95e5edc90e1d +#: 7810e85533f149de9636e60027aab69f 78944d61f7f64c52a0bc10700a7d6844 +#: 808b6db4b3dc416184cd5e7582afeda0 80a54b43224e44d2a2e9c7bac00100fc +#: 8adfa0d53a5240f7bd479dac4d81a1cf a709e0c9f0df4a04bdddce7d90fade9a +#: c0647499da3c4c978cbc6450094b3956 c1b7071acd194a368bd48f15fd08ec09 +#: d80b4b9a5d7140f08a439a766664b464 e0befa9dc82343cabd1932746cdd1677 +#: e4007115154746ee8a75be2cfe846467 eaf1f629489a4863ba1de180890420c8 +#: ef7e23e42a34454799bca6354e66b428 fbccef7c9e0345dbae7f15f3153fcccd +#: fd85b70e25d246a48a28f19a54d050df +msgid "Return type" +msgstr "戻り値の型" + +#: ../../vars.rst:20 866f952708574548a503bb60807a9b78 +msgid "Predefined RGB colorspace *fitz.Colorspace(fitz.CS_RGB)*." +msgstr "事前定義されたRGBカラースペース *fitz.Colorspace(fitz.CS_RGB)*。" + +#: ../../vars.rst:22 ../../vars.rst:28 ../../vars.rst:34 +#: 21c7240d7c46450690c9f7e46e265349 4102bd863cbb49709adb9803af8540d0 +#: 692cec7bfe4142a59f1c4c58e24fdfad +msgid ":ref:`Colorspace`" +msgstr ":ref:`Colorspace`" + +#: ../../vars.rst:26 f11344348fa943e29e6b47ff0b604c53 +msgid "Predefined GRAY colorspace *fitz.Colorspace(fitz.CS_GRAY)*." +msgstr "事前定義されたGRAYカラースペース *fitz.Colorspace(fitz.CS_GRAY)*。" + +#: ../../vars.rst:32 469db11ec52d4ccfbd98c3937e516dca +msgid "Predefined CMYK colorspace *fitz.Colorspace(fitz.CS_CMYK)*." +msgstr "事前定義されたCMYKカラースペース *fitz.Colorspace(fitz.CS_CMYK)*。" + +#: ../../vars.rst:38 4ae06e6b327a4062984e8ee93d856033 +msgid "1 -- Type of :ref:`Colorspace` is RGBA" +msgstr "1 – :ref:`Colorspace` のタイプはRGBA" + +#: ../../vars.rst:44 d47533dbda5149d18091eaef5f08b493 +msgid "2 -- Type of :ref:`Colorspace` is GRAY" +msgstr "2 – :ref:`Colorspace` のタイプはGRAY" + +#: ../../vars.rst:50 16077722016d43a5a6c9655616265e09 +msgid "3 -- Type of :ref:`Colorspace` is CMYK" +msgstr "3 – :ref:`Colorspace` のタイプはCMYK" + +#: ../../vars.rst:56 3ca86393b866420d818d357a66c5b0e2 +msgid "'x.xx.x' -- version of PyMuPDF (these bindings)" +msgstr "‘x.xx.x’ – PyMuPDF（これらのバインディング）のバージョン" + +#: ../../vars.rst:62 2f6a83ac0ce34bc9a67b45452a80a443 +msgid "'x.xxx' -- version of MuPDF" +msgstr "‘x.xxx’ – MuPDFのバージョン" + +#: ../../vars.rst:68 e9b57851d2874c17a4059839b3a31cf3 +msgid "ISO timestamp *YYYY-MM-DD HH:MM:SS* when these bindings were built." +msgstr "これらのバインディングがビルドされたISOタイムスタンプ YYYY-MM-DD HH:MM:SS。" + +#: ../../vars.rst:72 58164b903cdc44b2a3368b5f4c15c947 +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。" + +#: ../../vars.rst:76 0938755cf23549bc873f6be89deed69c +msgid "" +"(VersionBind, VersionFitz, timestamp) -- combined version information " +"where *timestamp* is the generation point in time formatted as " +"\"YYYYMMDDhhmmss\"." +msgstr "(VersionBind、VersionFitz、タイムスタンプ) – タイムスタンプは「YYYYMMDDhhmmss」という形式で表される、生成時点の時間情報を結合したバージョン情報。" + + +#: ../../vars.rst:84 bd0ac665e4d744babee78fb231e33b66 +msgid "Document Permissions" +msgstr "ドキュメントの許可" + +#: ../../vars.rst:87 ../../vars.rst:105 ../../vars.rst:118 +#: 1aae7a71de4f4b359786fdc03a0bffff 5fb860c5e04b4d8d857d76b83f472aa6 +#: e84bc17b25d94b7aa2cfb2d1875629ad +msgid "Code" +msgstr "コード" + +#: ../../vars.rst:87 bf4ec133957340a4be9dfa6de1a1299a +msgid "Permitted Action" +msgstr "許可されたアクション" + +#: ../../vars.rst:89 099145ae5ce34e5a8f36ce0437f4563e +msgid "PDF_PERM_PRINT" +msgstr "" + +#: ../../vars.rst:89 2212f5d1a8424a6ba47813cf864612be +msgid "Print the document" +msgstr "文書を印刷する" + +#: ../../vars.rst:90 4b90a071ff6f4416b65d7ec2660a708c +msgid "PDF_PERM_MODIFY" +msgstr "" + +#: ../../vars.rst:90 22f7457c358c427e9dd9187183d2e064 +msgid "Modify the document's contents" +msgstr "文書の内容を変更する" + +#: ../../vars.rst:91 e2dc814b9db54722879e6e1a199178a4 +msgid "PDF_PERM_COPY" +msgstr "" + +#: ../../vars.rst:91 59384384562e4f1a9cda506eceabae3c +msgid "Copy or otherwise extract text and graphics" +msgstr "テキストやグラフィックスをコピーしたりその他の抽出を行う" + +#: ../../vars.rst:92 4fdea2034e30472ba1c19c66db07833f +msgid "PDF_PERM_ANNOTATE" +msgstr "" + +#: ../../vars.rst:92 af33feed6ae0464aa1c67d30c5528714 +msgid "Add or modify text annotations and interactive form fields" +msgstr "テキスト注釈やインタラクティブなフォームフィールドを追加または変更する" + +#: ../../vars.rst:93 dc4e74b2175948a7ba34dca88976a2a2 +msgid "PDF_PERM_FORM" +msgstr "" + +#: ../../vars.rst:93 324494cc65b14c61b4913becdfea457c +msgid "Fill in forms and sign the document" +msgstr "フォームに記入し、文書に署名する" + +#: ../../vars.rst:94 e7f29cad5faf476a999972e61c429f9f +msgid "PDF_PERM_ACCESSIBILITY" +msgstr "" + +#: ../../vars.rst:94 c57866df8ec6452b8d252dd38dca587a +msgid "Obsolete, always permitted" +msgstr "廃止されましたが、常に許可されています" + +#: ../../vars.rst:95 c57de1b7e5304f5a94620f134118b981 +msgid "PDF_PERM_ASSEMBLE" +msgstr "" + +#: ../../vars.rst:95 7da892659a8844bfa572872e5450af9b +msgid "Insert, rotate, or delete pages, bookmarks, thumbnail images" +msgstr "ページの挿入、回転、削除、ブックマーク、サムネイル画像の操作" + +#: ../../vars.rst:96 4e77da93685c4a94938c4ae21078ad35 +msgid "PDF_PERM_PRINT_HQ" +msgstr "" + +#: ../../vars.rst:96 d46478fc97114ca5938f5b6f72dbae29 +msgid "High quality printing" +msgstr "高品質印刷" + +#: ../../vars.rst:102 ac9198e86e0544b2aea29e4e10b93077 +msgid "PDF Optional Content Codes" +msgstr "PDFオプショナルコンテンツコード" + +#: ../../vars.rst:105 ../../vars.rst:118 87b7b0f1457e41c1a09bc43752d947aa +#: ee446124f83f4b5b8a64f0368aa2d79b +msgid "Meaning" +msgstr "意味" + +#: ../../vars.rst:107 da8e9a62e38742d19aa3f2e19d4826b7 +msgid "PDF_OC_ON" +msgstr "" + +#: ../../vars.rst:107 a1dea393b93b45df8d45a87e7f040f6f +msgid "Set an OCG to ON temporarily" +msgstr "一時的にOCGをONに設定します" + +#: ../../vars.rst:108 01b3242228324b41ad16708c75f20493 +msgid "PDF_OC_TOGGLE" +msgstr "" + +#: ../../vars.rst:108 92e15dd9ff154f7a9097126ea89e6f96 +msgid "Toggle OCG status temporarily" +msgstr "OCGステータスを一時的に切り替えます" + +#: ../../vars.rst:109 413140cd949c49be97454baff52d0111 +msgid "PDF_OC_OFF" +msgstr "" + +#: ../../vars.rst:109 949797aefee042f0a71ed3a9aa0f67f3 +msgid "Set an OCG to OFF temporarily" +msgstr "一時的にOCGをOFFに設定します" + +#: ../../vars.rst:115 56fc76e8d4ee42ae9892c2f8ea125bf7 +msgid "PDF encryption method codes" +msgstr "PDF暗号化方式コード" + +#: ../../vars.rst:120 6af50af80e144941b69ce081fdace986 +msgid "PDF_ENCRYPT_KEEP" +msgstr "" + +#: ../../vars.rst:120 8ad438060f424ddcaa8d91bca11edca6 +msgid "do not change" +msgstr "変更しない" + +#: ../../vars.rst:121 161fab2c28424bbfbb4a40c21c48559a +msgid "PDF_ENCRYPT_NONE" +msgstr "" + +#: ../../vars.rst:121 13509cf83ec94384b66b067d66272d13 +msgid "remove any encryption" +msgstr "暗号化を解除する" + +#: ../../vars.rst:122 c4f163b0ea7146a6b3174522733ef550 +msgid "PDF_ENCRYPT_RC4_40" +msgstr "" + +#: ../../vars.rst:122 000350cfd5cd433cb9b98cec5e60e636 +msgid "RC4 40 bit" +msgstr "RC4 40ビット" + +#: ../../vars.rst:123 4f021eda019442d98c6422ccfa6f1eae +msgid "PDF_ENCRYPT_RC4_128" +msgstr "" + +#: ../../vars.rst:123 c277864d96674a7a81a20e458c5348e4 +msgid "RC4 128 bit" +msgstr "RC4 128ビット" + +#: ../../vars.rst:124 528bc5ac01594e6ca9aeaf047e3e6414 +msgid "PDF_ENCRYPT_AES_128" +msgstr "" + +#: ../../vars.rst:124 9910f0008cfe423d964e0e30f24a56e1 +msgid "*Advanced Encryption Standard* 128 bit" +msgstr "*Advanced Encryption Standard* 128ビット" + +#: ../../vars.rst:125 8cd814b0d890468f92f0f1ce9a05356a +msgid "PDF_ENCRYPT_AES_256" +msgstr "" + +#: ../../vars.rst:125 2cd94a657d2a4d5eac5849a4fbd5bf3d +msgid "*Advanced Encryption Standard* 256 bit" +msgstr "*Advanced Encryption Standard* 256ビット" + +#: ../../vars.rst:126 082b0b44a7d047bb8457ff3090e4ec17 +msgid "PDF_ENCRYPT_UNKNOWN" +msgstr "" + +#: ../../vars.rst:126 54b9971bf2ed4441a93fe5dea1bafac8 +msgid "unknown" +msgstr "不明" + +#: ../../vars.rst:132 90dd48f5850c4c3c84331c8af3d6cc03 +msgid "Font File Extensions" +msgstr "フォントファイルの拡張子" + +#: ../../vars.rst:133 a1141d4f88474c3399698b6084db3149 +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:136 78e3151d05a94c6bbba1f96d6b077125 +msgid "Ext" +msgstr "拡張子" + +#: ../../vars.rst:136 bc73c6ccc1d842c6ab1cc91e56a2028b +msgid "Description" +msgstr "説明" + +#: ../../vars.rst:138 d9f9793ee7354031acdbd4ccc476d8ad +msgid "ttf" +msgstr "" + +#: ../../vars.rst:138 298047d991234dc596db9f0c4fed230d +msgid "TrueType font" +msgstr "TrueTypeフォント" + +#: ../../vars.rst:139 bb416467cae74c0a87f249b6ba8d8913 +msgid "pfa" +msgstr "" + +#: ../../vars.rst:139 ecf4a549aa9b4abb9b969a95a95dea81 +msgid "Postscript for ASCII font (various subtypes)" +msgstr "ASCII用のPostscriptフォント（さまざまなサブタイプ）" + +#: ../../vars.rst:140 e401332a02d84361931d913c4c785000 +msgid "cff" +msgstr "" + +#: ../../vars.rst:140 89490baeebb5476eae4e159d026c8edc +msgid "Type1C font (compressed font equivalent to Type1)" +msgstr "Type1Cフォント（Type1と同等の圧縮フォント）" + +#: ../../vars.rst:141 043c8723543f424eb48f05cd154d99d6 +msgid "cid" +msgstr "" + +#: ../../vars.rst:141 60b32f7914ae4296b3f22ee0472d8aea +msgid "character identifier font (postscript format)" +msgstr "文字識別子フォント（Postscript形式）" + +#: ../../vars.rst:142 f8d149fbd4c44534a9b9d68fdfa6ddfb +msgid "otf" +msgstr "" + +#: ../../vars.rst:142 9e899a1fe36a4c5c9aab4ada34c471cd +msgid "OpenType font" +msgstr "OpenTypeフォント" + +#: ../../vars.rst:143 095c63aea31b48278c9c31e7ca0f368b +msgid "n/a" +msgstr "" + +#: ../../vars.rst:143 08968524b26e42fd99d51f9a3087b8e0 +msgid "not extractable, e.g. :ref:`Base-14-Fonts`, Type 3 fonts and others" +msgstr "抽出できない、 :ref:`PDFベース14フォント ` 、Type 3フォント、その他" + +#: ../../vars.rst:149 5516680222e64dfc87106457945d4d2e +msgid "Text Alignment" +msgstr "テキストの配置" + +#: ../../vars.rst:152 2da44d464e374bbea8c8ec936d3bfdd8 +msgid "0 -- align left." +msgstr "0 – 左揃え。" + +#: ../../vars.rst:156 dc8af1af12b746608f1b9bc266fcaed7 +msgid "1 -- align center." +msgstr "1 – 中央揃え。" + +#: ../../vars.rst:160 1ca48589bbc445fc8e34c32d312bca62 +msgid "2 -- align right." +msgstr "2 – 右揃え。" + +#: ../../vars.rst:164 20547ed92d274dd3ab2e1efb42aac73b +msgid "3 -- align justify." +msgstr "3 – 両端揃え。" + +#: ../../vars.rst:169 f7402c2578234fe78eaa355597064b36 +msgid "Text Extraction Flags" +msgstr "テキスト抽出フラグ" + +#: ../../vars.rst:170 cd42307d3a934664ad84d9fcd7a9c1b1 +msgid "" +"Option bits controlling the amount of data, that are parsed into a " +":ref:`TextPage` -- this class is mainly used only internally in PyMuPDF." +msgstr ":ref:`TextPage` に解析されるデータの量を制御するオプションビット - このクラスは、主にPyMuPDF内部でのみ使用されます。" + +#: ../../vars.rst:172 1786bc533e2c4020b5661329a84ccc01 +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:176 cf4fb784cd5649d89648e7adac92e2b7 +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:180 0a95532c0a4a4277a3f89788739eda8f +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:184 378bac256c884154a80c9db4e7aa8e33 +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:188 2bffab76a52b41e7a6f1ccc2ba6aeaa9 +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:192 5c23c43d9f024f189479547d35badc0a +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:196 91cad6c3750f44c2b99c71753850a114 +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:200 9e74742865d54ef7873a4113b96905f4 +msgid "" +"64 -- If set, characters entirely outside a page's **mediabox** will be " +"ignored. This is default in PyMuPDF." +msgstr "64 – ページのメディアボックス外にある文字は無視されます。これはPyMuPDFのデフォルトです。" + +#: ../../vars.rst:202 b6d4bf73d4b94bbeb66dc3fd83c8b1ad +msgid "" +"The following constants represent the default combinations of the above " +"for text extraction and searching:" +msgstr "以下の定数は、テキスト抽出と検索のための上記のデフォルトの組み合わせを表します：" + +#: ../../vars.rst:206 ../../vars.rst:210 ../../vars.rst:214 ../../vars.rst:234 +#: 1a570c887e554980b8981e72d3780732 3ccee9fa94dd4df29cc2fd68329dc585 +#: e20746c04d2c47ebacddd0b0c6e102f4 ed9e1e778680466f9cf25400a2632825 +msgid "`TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP`" +msgstr "" + +#: ../../vars.rst:218 ../../vars.rst:222 ../../vars.rst:226 ../../vars.rst:230 +#: 1a22e3aeaa06435b86d37543875a5a89 4b3cddd428104881971970380a4bb719 +#: 634b57c524b84e14a6ee08ce5faf030e 9b4531984266449fad18655916a24c68 +msgid "" +"`TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP " +"| TEXT_PRESERVE_IMAGES`" +msgstr "" + +#: ../../vars.rst:238 1ab461971c254eb9aa563943a3595f0b +msgid "" +"`TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP " +"| TEXT_DEHYPHENATE`" +msgstr "" + +#: ../../vars.rst:244 676eda0d737d4b87b21d3e4c78463a01 +msgid "Link Destination Kinds" +msgstr "リンクの目的の種類" + +#: ../../vars.rst:245 e8660ef597264e7aa2de401fc2c4c0c3 +msgid "Possible values of :attr:`linkDest.kind` (link destination kind)." +msgstr ":attr:`linkDest.kind` （リンクの目的の種類）の可能な値。" + +#: ../../vars.rst:249 aca5863efce649efa7b87ea66dea745f +msgid "0 -- No destination. Indicates a dummy link." +msgstr "0 – 目的地なし。ダミーリンクを示します。" + +#: ../../vars.rst:255 d3080c1371494d698a109bd7eced0591 +msgid "1 -- Points to a place in this document." +msgstr "1 – このドキュメント内の場所を指します。" + +#: ../../vars.rst:261 54715366035943d4901d2694dacbf047 +msgid "" +"2 -- Points to a URI -- typically a resource specified with internet " +"syntax." +msgstr "2 – URIを指します。通常はインターネット構文で指定されたリソースです。" + +#: ../../vars.rst:267 96a9bbbd9f2c478fbda0c58c23cad0f3 +msgid "3 -- Launch (open) another file (of any \"executable\" type)." +msgstr "3 – 別のファイル（任意の「実行可能」タイプ）を開きます。" + +#: ../../vars.rst:273 3898a2289ff04e48833630d93e968520 +msgid "4 -- points to a named location." +msgstr "4 – 名前付きの場所を指します。" + +#: ../../vars.rst:279 c4fb3bc54e434845b7f2bbb91c1d534d +msgid "5 -- Points to a place in another PDF document." +msgstr "5 – 別のPDFドキュメント内の場所を指します。" + +#: ../../vars.rst:286 a811cc5d04a84f6fac14298055f4d297 +msgid "Link Destination Flags" +msgstr "リンクの目的地フラグ" + +#: ../../vars.rst:288 5e153b36b3e04e0793ec6bc1d43847bb +msgid "" +"The rightmost byte of this integer is a bit field, so test the truth of " +"these bits with the *&* operator." +msgstr "この整数の最も右側のバイトはビットフィールドです。したがって、これらのビットの真偽を *＆* 演算子でテストします。" + +#: ../../vars.rst:292 2c33ff7730024e5e8912d37b894451dd +msgid "1 (bit 0) Top left x value is valid" +msgstr "1 (ビット 0) 左上の x 値が有効です" + +#: ../../vars.rst:298 266604d01d2147f68d5dbd9898cb4edd +msgid "2 (bit 1) Top left y value is valid" +msgstr "2 (ビット 1) 左上の y 値が有効です" + +#: ../../vars.rst:304 58bf062ea62247be92b1161a0d0d99ee +msgid "4 (bit 2) Bottom right x value is valid" +msgstr "4 (ビット 2) 右下の x 値が有効です" + +#: ../../vars.rst:310 7b87c859405f4f00a83584717887c8f8 +msgid "8 (bit 3) Bottom right y value is valid" +msgstr "8 (ビット 3) 右下の y 値が有効です" + +#: ../../vars.rst:316 0497f78944824f0081d895ec73319f89 +msgid "16 (bit 4) Horizontal fit" +msgstr "16 (ビット 4) 水平フィット" + +#: ../../vars.rst:322 cfcbf55e8a9848b9a0ba22fde0472c91 +msgid "32 (bit 5) Vertical fit" +msgstr "32 (ビット 5) 垂直フィット" + +#: ../../vars.rst:328 4c67e16673a549a0bf3415f534986d08 +msgid "64 (bit 6) Bottom right x is a zoom figure" +msgstr "64 (ビット 6) 右下の x はズーム値です" + + +#: ../../vars.rst:334 2aff1a7067e24ffa9b2f4ab3b82a6afb +msgid "Annotation Related Constants" +msgstr "注釈関連の定数" + +#: ../../vars.rst:335 5b36a530969a46f7ad217c74718ed704 +msgid "See chapter 8.4.5, pp. 615 of the :ref:`AdobeManual` for details." +msgstr "詳細については、:ref:`Adobe PDFリファレンス ` の第8.4.5章、615ページをご覧ください。" + +#: ../../vars.rst:340 ebf4dcbadb944860ae29390c58973ec5 +msgid "Annotation Types" +msgstr "アノテーションタイプ" + +#: ../../vars.rst:341 d988884be2cd47b68d2bb5ce4c0dda7b +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:378 02b6f26bc2c240579ea13a7db8a7eea6 +msgid "Annotation Flag Bits" +msgstr "注釈フラグビット" + +#: ../../vars.rst:395 b58b3f61c2ee4e0f9f18b64a483e3676 +msgid "Annotation Line Ending Styles" +msgstr "注釈の線の終端スタイル" + +#: ../../vars.rst:411 783da63409904d89a50a91ca73c2c0c9 +msgid "Widget Constants" +msgstr "ウィジェットの定数" + +#: ../../vars.rst:416 851f7a6f5b51434b91b7059fa24654c8 +msgid "Widget Types (*field_type*)" +msgstr "ウィジェットのタイプ（*field_type*）" + +#: ../../vars.rst:429 207aca8b91dc4e0b8db757c7b7db725c +msgid "Text Widget Subtypes (*text_format*)" +msgstr "テキストウィジェットのサブタイプ（*text_format*）" + +#: ../../vars.rst:440 e0d3f52344ea47e1a8d3f46c739b22b6 +msgid "Widget flags (*field_flags*)" +msgstr "ウィジェットフラグ（*field_flags*）" + +#: ../../vars.rst:441 9b9e0a9526524e95b264aa036222af95 +msgid "**Common to all field types**::" +msgstr "**すべてのフィールドタイプに共通**：" + +#: ../../vars.rst:447 2a61b982cabe4f5f92915cdf0f190f1d +msgid "**Text widgets**::" +msgstr "**テキストウィジェット**：" + +#: ../../vars.rst:457 2dc908353bd146a797402fd52faaa9af +msgid "**Button widgets**::" +msgstr "**ボタンウィジェット**：" + +#: ../../vars.rst:464 0c62578bcf304b99a273926e7d8d4b15 +msgid "**Choice widgets**::" +msgstr "**チョイスウィジェット**：" + +#: ../../vars.rst:477 4e2c9e01f16e465d817fcb2d8dc88cc8 +msgid "PDF Standard Blend Modes" +msgstr "PDF標準ブレンドモード" + +#: ../../vars.rst:479 fcc603aa265d4256a0e7b7a0ba09028a +msgid "For an explanation see :ref:`AdobeManual`, page 324::" +msgstr "詳細については、Adobe PDFリファレンスのページ324をご覧ください：" + +#: ../../vars.rst:502 f0ef9080d0f9462e9d315ad4566a4785 +msgid "Stamp Annotation Icons" +msgstr "スタンプ注釈アイコン" + +#: ../../vars.rst:503 fa47d0c4e56d4c699ce6efebcfd5702e +msgid "MuPDF has defined the following icons for **rubber stamp** annotations::" +msgstr "MuPDFは、ラバースタンプ注釈に次のアイコンを定義しています：" + +#: ../../footer.rst:-1 4960f77af59544b980fee580637a1423 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/version.mo b/docs/locales/ja/LC_MESSAGES/version.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/version.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/version.po b/docs/locales/ja/LC_MESSAGES/version.po new file mode 100644 index 000000000..bb545316e --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/version.po @@ -0,0 +1,34 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../version.rst:3 7a589219fa82453a99d14b46e44a158d +msgid "" +"This documentation covers **PyMuPDF v1.23.0rc1** features as of " +"**2023-08-10 00:00:01**." +msgstr "" + +#: ../../version.rst:5 0d8708888083483da042bc1e9179474f +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 "" + diff --git a/docs/locales/ja/LC_MESSAGES/widget.mo b/docs/locales/ja/LC_MESSAGES/widget.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/widget.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/widget.po b/docs/locales/ja/LC_MESSAGES/widget.po new file mode 100644 index 000000000..a4e91cbae --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/widget.po @@ -0,0 +1,546 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../widget.rst:7 f3ff9ab383f64583bef3a2bc6c3ddfa3 +msgid "Widget" +msgstr "" + +#: ../../widget.rst:9 4fe6d8cde9ab4216b70ebfafe183a911 +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 "" + +#: ../../widget.rst:11 085da0803a24409f959ac588b14f729d +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 "" + +#: ../../widget.rst:13 1cfe7de19a1f4d688433802363d08162 +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 "" + +#: ../../widget.rst:16 26db3e9561264c0da9cf6eb56606b24c +msgid "**Class API**" +msgstr "" + +#: ../../widget.rst:22 f9f9024cd7554a868afe2934891af3e4 +msgid "*New in version 1.18.15*" +msgstr "" + +#: ../../widget.rst:24 ab010ed9635b493baf99aa3368ab1d53 +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 "" + +#: ../../widget.rst:26 7899919b468a47c0bbc353871bb6cbb0 +msgid "" +"This method helps finding out the possible values of :attr:`field_value` " +"in these cases." +msgstr "" + +#: ../../widget.rst 47a3f86fe85d46a2ac849be3058dde04 +#: 4fcba86f59614966be8005cf72df3dee +msgid "returns" +msgstr "" + +#: ../../widget.rst:28 99e7409494ea440a85e0f9f11e55beb9 +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 "" + +#: ../../widget.rst:36 1feb3c8691674769b3037a63efef8374 +msgid "New in version 1.22.2" +msgstr "" + +#: ../../widget.rst:38 252300dc94874a6d9a0631caaf8bb99e +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 "" + +#: ../../widget.rst:40 a1c7443e17c14532a691bad9d3fc930b +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 "" + +#: ../../widget.rst:47 3266ac1d96e342b48d509f3d6904c889 +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:56 cf8c6dc65d9f4f8694210639e6c4879d +msgid "" +"After any changes to a widget, this method **must be used** to store them" +" in the PDF [#f1]_." +msgstr "" + +#: ../../widget.rst:60 11867ef0ca8d4ecaab3f8dfcebe26d9a +msgid "" +"Reset the field's value to its default -- if defined -- or remove it. Do " +"not forget to issue :meth:`update` afterwards." +msgstr "" + +#: ../../widget.rst:64 d5329379565443bf8f783e9ea98941f2 +msgid "Point to the next form field on the page. The last widget returns *None*." +msgstr "" + +#: ../../widget.rst:68 98a79a2ff91441279191c815a73850d3 +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 "" + +#: ../../widget.rst:72 eef4ef56ddfa459ca227148f83707788 +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 "" + +#: ../../widget.rst:76 9a1da25a72484c6886e543327a4d5619 +msgid "A float defining the width of the border line. Default is 1." +msgstr "" + +#: ../../widget.rst:80 d1e30f1eacfb4c40882d2c6761ab6758 +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 "" + +#: ../../widget.rst:84 d35addf5e226468d879b05ff8a19b33e +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 "" + +#: ../../widget.rst:88 ee3a6b1f469d4ca69488c5513b161990 +msgid "" +"A mandatory string defining the field's name. No checking for duplicates " +"takes place." +msgstr "" + +#: ../../widget.rst:92 913cac94165346bd8344c4c1113de338 +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:96 bab7f034d2064b9594eb6b715e6ecc6f +msgid "The value of the field." +msgstr "" + +#: ../../widget.rst:100 4ce3b89614ee4560968f63f44d745148 +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:104 af35584f017b49dfb7fe48995d43791f +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 "" + +#: ../../widget.rst:108 2384aa4111bd446dafb0c25782700ad1 +msgid "A string describing (and derived from) the field type." +msgstr "" + +#: ../../widget.rst:112 bb38a15abc6840378d37f5e970116253 +msgid "A list of up to 4 floats defining the field's background color." +msgstr "" + +#: ../../widget.rst:116 29cf1321886d4362be9f120f448f273c +msgid "The caption string of a button-type field." +msgstr "" + +#: ../../widget.rst:120 9aa35a8c1b4e40d091dd4a472242a7e5 +msgid "A bool indicating the signing status of a signature field, else *None*." +msgstr "" + +#: ../../widget.rst:124 a7b8b1e822884fa582fa17db4dd9e760 +msgid "The rectangle containing the field." +msgstr "" + +#: ../../widget.rst:128 64bd85c5b71e417183b0a9bb761917d2 +msgid "" +"A list of **1, 3 or 4 floats** defining the text color. Default value is " +"black (`[0, 0, 0]`)." +msgstr "" + +#: ../../widget.rst:132 f9bdc60293fd429d9c8d52a4f238db12 +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 "" + +#: ../../widget.rst:136 6e7b2676f6874cb89da74ff21eb3b294 +msgid "" +"A float defining the text 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 "" + +#: ../../widget.rst:140 6a424207b4b74a8787e7f6e568c9cd01 +msgid "" +"An integer defining the maximum number of text characters. PDF viewers " +"will (should) not accept a longer text." +msgstr "" + +#: ../../widget.rst:144 4510d6f6ca35461087c0a3728737aaad +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:148 92997d34040a4e12b13388101cdd16d7 +msgid "The PDF :data:`xref` of the widget." +msgstr "" + +#: ../../widget.rst:152 ../../widget.rst:158 ../../widget.rst:164 +#: ../../widget.rst:170 ../../widget.rst:176 020abe15c80c4de1afcfa1ed0659c4b4 +#: 314d037db3734aa4895b1e7d8cf133ce 406b16055513431893bb4a355acd38e0 +#: 635d8812ea3d4c148fcf240a9dabaedb fd4d4561a71b4be49381eacb4246a927 +msgid "New in version 1.16.12" +msgstr "" + +#: ../../widget.rst:154 931dd99dbdc649269dc7e27a8ad98bd6 +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 "" + +#: ../../widget.rst:160 fd47e8e2e7624096b4a29cc61007aec2 +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 "" + +#: ../../widget.rst:166 57dd217f9b924bdab6500df1842bd2f9 +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 "" + +#: ../../widget.rst:172 1fe4dca96687413390f17f1805be6222 +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 "" + +#: ../../widget.rst:178 369a583b0dd140f391c42ef00d35994a +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 "" + +#: ../../widget.rst:182 ../../widget.rst:188 7d002d2025054bd49d9c4dbb55a1a0be +#: 8b50552446d7484fb53e466f6a08cc97 +msgid "New in version 1.22.6" +msgstr "" + +#: ../../widget.rst:184 b0f84c5b0618432ca4fa58db8bcc24ab +msgid "" +"JavaScript text (unicode) to be performed on losing the focus of this " +"field. *None* if not present." +msgstr "" + +#: ../../widget.rst:190 ee683e73ff224af6ad6f2f1345dd7d22 +msgid "" +"JavaScript text (unicode) to be performed on focusing this field. *None* " +"if not present." +msgstr "" + +#: ../../widget.rst:194 8fed47bda7204713814b9c9bdd067fcf +msgid "For **adding** or **changing** one of the above scripts," +msgstr "" + +#: ../../widget.rst:195 0158f09aa9774600abfd96f16e53f98c +msgid "" +"just put the appropriate JavaScript source code in the widget attribute. " +"To **remove** a script, set the respective attribute to *None*." +msgstr "" + +#: ../../widget.rst:198 991ff5d3867b4db186234c4180908055 +msgid "Button fields only support :attr:`script`." +msgstr "" + +#: ../../widget.rst:199 1074cbbd05ab45b6898bd04048a0a950 +msgid "Other script entries will automatically be set to *None*." +msgstr "" + +#: ../../widget.rst:201 47321bc3148a46f799dff527c1f0cc7b +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 "" + +#: ../../widget.rst:213 67ae13e94c9642c8b6d7d08869605b53 +msgid "Standard Fonts for Widgets" +msgstr "" + +#: ../../widget.rst:214 036455a0fef54a738530a0fbcd28ffb9 +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 "" + +#: ../../widget.rst:216 cbf6e883a3ef4798a22934e93e42037c +msgid "" +"To find out already existing field fonts, inspect the list " +":attr:`Document.FormFonts`." +msgstr "" + +#: ../../widget.rst:219 b997f96608174cec8505cda2faa48a8f +msgid "**Reference**" +msgstr "" + +#: ../../widget.rst:219 cf93273d85e4462e857398932aee0b7e +msgid "**Base14 Fontname**" +msgstr "" + +#: ../../widget.rst:221 dc7046f8c02f4db38c326379895a2028 +msgid "CoBI" +msgstr "" + +#: ../../widget.rst:221 aad4e619901443b6943b59bd43a20d37 +msgid "Courier-BoldOblique" +msgstr "" + +#: ../../widget.rst:222 a140f78dbc794a1b8cfd4095d86116d8 +msgid "CoBo" +msgstr "" + +#: ../../widget.rst:222 2bdc65da1cd5452dbe2eb2f80f6e64e4 +msgid "Courier-Bold" +msgstr "" + +#: ../../widget.rst:223 bf0854489d84477192a6ca0a7f69969f +msgid "CoIt" +msgstr "" + +#: ../../widget.rst:223 9e01d3257dfe4d7f9ab38406642bda75 +msgid "Courier-Oblique" +msgstr "" + +#: ../../widget.rst:224 78d27163d01148bba50b734ad4ec557d +msgid "Cour" +msgstr "" + +#: ../../widget.rst:224 482b1899935f421f934a08b87982eb21 +msgid "Courier" +msgstr "" + +#: ../../widget.rst:225 dfb1397259a24f129569317f81ec228a +msgid "HeBI" +msgstr "" + +#: ../../widget.rst:225 439c538ac739404f9ade7f22abc3ebad +msgid "Helvetica-BoldOblique" +msgstr "" + +#: ../../widget.rst:226 9f858d57478f47d997964eff176d1ef1 +msgid "HeBo" +msgstr "" + +#: ../../widget.rst:226 6710af868bfb4228b256621972518220 +msgid "Helvetica-Bold" +msgstr "" + +#: ../../widget.rst:227 5c6f24abb2034c43bad3a793363bfa04 +msgid "HeIt" +msgstr "" + +#: ../../widget.rst:227 eb53c7dd546f4485a1ec560f595f0ceb +msgid "Helvetica-Oblique" +msgstr "" + +#: ../../widget.rst:228 da55478d6d784d78a62e0d634f50308f +msgid "Helv" +msgstr "" + +#: ../../widget.rst:228 a3b4a959ce764ffd8a739af01786e470 +msgid "Helvetica **(default)**" +msgstr "" + +#: ../../widget.rst:229 4d2c93b2fe4b4aebafc2b9ab204c61cb +msgid "Symb" +msgstr "" + +#: ../../widget.rst:229 6fd6129e35834b35826ee303e147159e +msgid "Symbol" +msgstr "" + +#: ../../widget.rst:230 a8d5649d47ae42cc8fbb3fe204722ff9 +msgid "TiBI" +msgstr "" + +#: ../../widget.rst:230 cf12706522d748d1b3c57054e0d167a1 +msgid "Times-BoldItalic" +msgstr "" + +#: ../../widget.rst:231 012c7926b76744febb42fb4fe1aa8c04 +msgid "TiBo" +msgstr "" + +#: ../../widget.rst:231 54bdf95b55fa484b9b995aeb9fbf7843 +msgid "Times-Bold" +msgstr "" + +#: ../../widget.rst:232 592764f3ae624d72a884656c405b4a46 +msgid "TiIt" +msgstr "" + +#: ../../widget.rst:232 ce993268a280457190307e360c6bf88c +msgid "Times-Italic" +msgstr "" + +#: ../../widget.rst:233 f9d13937b4e54413b543a1a80673bf64 +msgid "TiRo" +msgstr "" + +#: ../../widget.rst:233 e0a4e76cde46492cbaf5d8f45e042d9c +msgid "Times-Roman" +msgstr "" + +#: ../../widget.rst:234 c19ebddba8db4ca4a1e70fff7eecb832 +msgid "ZaDb" +msgstr "" + +#: ../../widget.rst:234 3b4fd91b39aa4146bb0405ff769f8d5f +msgid "ZapfDingbats" +msgstr "" + +#: ../../widget.rst:237 22c159c8926746fead43f685e335e562 +msgid "" +"You are generally free to use any font for every widget. However, we " +"recommend using *ZaDb* (\"ZapfDingbats\") and fontsize 0 for check boxes:" +" typical viewers will put a correctly sized tickmark in the field's " +"rectangle, when it is clicked." +msgstr "" + +#: ../../widget.rst:240 94e7d52b71654096948594a0c64c6385 +msgid "Supported Widget Types" +msgstr "" + +#: ../../widget.rst:241 73dc6a935ef7421f99000f432eb98bf0 +msgid "" +"PyMuPDF supports the creation and update of many, but not all widget " +"types." +msgstr "" + +#: ../../widget.rst:243 5281523b2b1b4800a2aeb2007a0d1383 +msgid "text (`PDF_WIDGET_TYPE_TEXT`)" +msgstr "" + +#: ../../widget.rst:244 857d26be9b9d43ffa45d6d68c2ca55fa +msgid "push button (`PDF_WIDGET_TYPE_BUTTON`)" +msgstr "" + +#: ../../widget.rst:245 4ae37820d73c40a5ac1911aaff56ff1c +msgid "check box (`PDF_WIDGET_TYPE_CHECKBOX`)" +msgstr "" + +#: ../../widget.rst:246 48acfd682f214378afaa789597385cf8 +msgid "combo box (`PDF_WIDGET_TYPE_COMBOBOX`)" +msgstr "" + +#: ../../widget.rst:247 09c5afa19bad463fa9722b95323c4b84 +msgid "list box (`PDF_WIDGET_TYPE_LISTBOX`)" +msgstr "" + +#: ../../widget.rst:248 1eca07da147f4194ad19cd5964e25d63 +msgid "" +"radio button (`PDF_WIDGET_TYPE_RADIOBUTTON`): PyMuPDF does not currently " +"support the **creation** of groups of (interconnected) radio buttons, " +"where setting one 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_sate()` to the field value. **De-" +"selecting** the button should be done assigning `False`." +msgstr "" + +#: ../../widget.rst:249 2fe08dbef95349c4949d7d403260c8e9 +msgid "signature (`PDF_WIDGET_TYPE_SIGNATURE`) **read only**." +msgstr "" + +#: ../../widget.rst:252 a1b219f9f9d14238812fd5aaa077a810 +msgid "Footnotes" +msgstr "" + +#: ../../widget.rst:253 0b8092e8a33147f1bee55f01a0f8b739 +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 "" + +#: ../../footer.rst:-1 dc6ce1b9ff8643f0ae957fe1361feea1 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/xml-class.mo b/docs/locales/ja/LC_MESSAGES/xml-class.mo new file mode 100644 index 000000000..bb1c33467 Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/xml-class.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/xml-class.po b/docs/locales/ja/LC_MESSAGES/xml-class.po new file mode 100644 index 000000000..4a56f3cbc --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/xml-class.po @@ -0,0 +1,998 @@ +# 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: 2023-08-16 14:20+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" + +#: ../../xml-class.rst:7 be172934f6d2433ab20434aaf415b60f +msgid "Xml" +msgstr "" + +#: ../../xml-class.rst:11 347b9105857b4692b275a0b49aa81317 +msgid "New in v1.21.0" +msgstr "" + +#: ../../xml-class.rst:13 b6a19d8ff444437384da16add590a065 +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-class.rst:15 c7fb8de0a7964273a8d2366b6bb99e5f +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 "" + +#: ../../xml-class.rst:19 b20e759d35904fa0a094fe78311dbdc7 +msgid "**Method / Attribute**" +msgstr "" + +#: ../../xml-class.rst:19 67246626d60c4bd3b629c675db6df72d +msgid "**Description**" +msgstr "" + +#: ../../xml-class.rst:21 71066c3cf5a14207b5bee674a37233d3 +msgid ":meth:`~.add_bullet_list`" +msgstr "" + +#: ../../xml-class.rst:21 46ab7f06d9d84680b06ff2408fc57d23 +msgid "Add a :htmlTag:`ul` tag - bulleted list, context manager." +msgstr "" + +#: ../../xml-class.rst:22 a8836549c6dc4eb5900b736ed18bcdfb +msgid ":meth:`~.add_codeblock`" +msgstr "" + +#: ../../xml-class.rst:22 663af812a3194a0b88721fde55a7b860 +msgid "Add a :htmlTag:`pre` tag, context manager." +msgstr "" + +#: ../../xml-class.rst:23 86901118c80f46359633b1f7a5686262 +msgid ":meth:`~.add_description_list`" +msgstr "" + +#: ../../xml-class.rst:23 30c7bede388144a0b928c42b17e4f376 +msgid "Add a :htmlTag:`dl` tag, context manager." +msgstr "" + +#: ../../xml-class.rst:24 2a4df24e4f6e4c6ea353ce0a3a9e2054 +msgid ":meth:`~.add_division`" +msgstr "" + +#: ../../xml-class.rst:24 34ca0fcfbe99453f97228e5c62a55a2f +msgid "add a :htmlTag:`div` tag (renamed from “section”), context manager." +msgstr "" + +#: ../../xml-class.rst:25 49b43da2808d40a6989c89ceb22b00a5 +msgid ":meth:`~.add_header`" +msgstr "" + +#: ../../xml-class.rst:25 19ce91b78be64a80ba28d446d9a86983 +msgid "Add a header tag (one of :htmlTag:`h1` to :htmlTag:`h6`), context manager." +msgstr "" + +#: ../../xml-class.rst:26 3eee0534310e4463972d0742fd597a23 +msgid ":meth:`~.add_horizontal_line`" +msgstr "" + +#: ../../xml-class.rst:26 e5b150f10cf942ee970a841513d34a56 +msgid "Add a :htmlTag:`hr` tag." +msgstr "" + +#: ../../xml-class.rst:27 d877ee51813c42b5a18387353605b93b +msgid ":meth:`~.add_image`" +msgstr "" + +#: ../../xml-class.rst:27 c8f22d6a31d94743a9581c8e9108895b +msgid "Add a :htmlTag:`img` tag." +msgstr "" + +#: ../../xml-class.rst:28 ff66afd40ab64ea596bac1ad9013ce07 +msgid ":meth:`~.add_link`" +msgstr "" + +#: ../../xml-class.rst:28 6cbc670758b44437bc66020de0974781 +msgid "Add a :htmlTag:`a` tag." +msgstr "" + +#: ../../xml-class.rst:29 377ff3e5b45d4e99b56f5234bf8f785d +msgid ":meth:`~.add_number_list`" +msgstr "" + +#: ../../xml-class.rst:29 fb0e81db236a464a98d7b24b1e68b8b4 +msgid "Add a :htmlTag:`ol` tag, context manager." +msgstr "" + +#: ../../xml-class.rst:30 66790baef6d24978955330b479d1ec27 +msgid ":meth:`~.add_paragraph`" +msgstr "" + +#: ../../xml-class.rst:30 0b9ac80ed59e4b3bb6617ba29f642e32 +msgid "Add a :htmlTag:`p` tag." +msgstr "" + +#: ../../xml-class.rst:31 53034cdc5ba0460abe207120c1b94018 +msgid ":meth:`~.add_span`" +msgstr "" + +#: ../../xml-class.rst:31 2ed5ab0b28684ddab4581e9d5a333081 +msgid "Add a :htmlTag:`span` tag, context manager." +msgstr "" + +#: ../../xml-class.rst:32 c566e25b5bcd4e6ab6e61045f46c4ab9 +msgid ":meth:`~.add_subscript`" +msgstr "" + +#: ../../xml-class.rst:32 45cb9bfb7ae04e5c9972bd5df918dfdd +msgid "" +"Add subscript text(:htmlTag:`sub` tag) - inline element, treated like " +"text." +msgstr "" + +#: ../../xml-class.rst:33 52ebb3a897084de498a02b5388091b76 +msgid ":meth:`~.add_superscript`" +msgstr "" + +#: ../../xml-class.rst:33 c3147dc16e114c5f8d3a3053c1386be7 +msgid "" +"Add subscript text (:htmlTag:`sup` tag) - inline element, treated like " +"text." +msgstr "" + +#: ../../xml-class.rst:34 ecf679bb7b5f4b0d9a4002956a2ff059 +msgid ":meth:`~.add_code`" +msgstr "" + +#: ../../xml-class.rst:34 ../../xml-class.rst:35 ../../xml-class.rst:36 +#: ../../xml-class.rst:37 4c5bb0a99a58487e8f7ccafdbded56f0 +#: 9e0882e26d8f4d15abc1aae24464b0e8 9f9a66d22a374d9892e96478540515aa +#: bcb79ad9873940ac8178990fbeaaa646 +msgid "Add code text (:htmlTag:`code` tag) - inline element, treated like text." +msgstr "" + +#: ../../xml-class.rst:35 4bf93f5b7ee14b9fb6ff3425c4a26979 +msgid ":meth:`~.add_var`" +msgstr "" + +#: ../../xml-class.rst:36 d674e82284ac44f99af00db7f243d733 +msgid ":meth:`~.add_samp`" +msgstr "" + +#: ../../xml-class.rst:37 99f72109dacf48e9b7d412aed23279ca +msgid ":meth:`~.add_kbd`" +msgstr "" + +#: ../../xml-class.rst:38 ac28df036f4e4982a9e5baaacc56b280 +msgid ":meth:`~.add_text`" +msgstr "" + +#: ../../xml-class.rst:38 ../../xml-class.rst:162 +#: 4a15e85687de4ea1890da0e9c6c92953 8891babf69f54eed92b510cde8902978 +msgid "Add a text string. Line breaks `\\n` are honored as :htmlTag:`br` tags." +msgstr "" + +#: ../../xml-class.rst:39 d58cdff388a14d54b04fd00a31d98377 +msgid ":meth:`~.append_child`" +msgstr "" + +#: ../../xml-class.rst:39 bbc0401495d843f1b7ab4ab068db9058 +msgid "Append a child node." +msgstr "" + +#: ../../xml-class.rst:40 613f56988c6c40ea929654116484cf48 +msgid ":meth:`~.clone`" +msgstr "" + +#: ../../xml-class.rst:40 f18becf58adf4bc18f9aa3ea8467069f +msgid "Make a copy if this node." +msgstr "" + +#: ../../xml-class.rst:41 c0ea3fcdcc13419cae48ae091c9fcb9e +msgid ":meth:`~.create_element`" +msgstr "" + +#: ../../xml-class.rst:41 e9cf0ee0b9c140ee9e86862723358cee +msgid "Make a new node with a given tag name." +msgstr "" + +#: ../../xml-class.rst:42 674827fcff3c470fa3c6aadbfb201d00 +msgid ":meth:`~.create_text_node`" +msgstr "" + +#: ../../xml-class.rst:42 ../../xml-class.rst:306 +#: 2c36f7334e524988b6c65c40725fef81 57ce94f80dbe455798d20994c73e557a +msgid "Create direct text for the current node." +msgstr "" + +#: ../../xml-class.rst:43 8dae4647e28b4815b4d1fe8965c9b586 +msgid ":meth:`~.find`" +msgstr "" + +#: ../../xml-class.rst:43 14a19e4c5dcb4b7b8e27f16f8e405743 +msgid "Find a sub-node with given properties." +msgstr "" + +#: ../../xml-class.rst:44 0ad0c6c7c24841c5a2e39b4de8900d23 +msgid ":meth:`~.find_next`" +msgstr "" + +#: ../../xml-class.rst:44 336599d039304f8b85674d98c8769aea +msgid "Repeat previous \"find\" with the same criteria." +msgstr "" + +#: ../../xml-class.rst:45 f56f8c253a64491cada8abd92aea823a +msgid ":meth:`~.insert_after`" +msgstr "" + +#: ../../xml-class.rst:45 f13a408e5bf8499d8d42b68775321f2f +msgid "Insert an element after current node." +msgstr "" + +#: ../../xml-class.rst:46 d399642c4d7f4200a505eae5c4ee2d15 +msgid ":meth:`~.insert_before`" +msgstr "" + +#: ../../xml-class.rst:46 25d7a170e0c4490aa5ff3a3d478556ff +msgid "Insert an element before current node." +msgstr "" + +#: ../../xml-class.rst:47 3e34112ed8da42f088485bea5975837c +msgid ":meth:`~.remove`" +msgstr "" + +#: ../../xml-class.rst:47 2c4eafb2e75b4f2f911a5e373eb93fef +msgid "Remove this node." +msgstr "" + +#: ../../xml-class.rst:48 e87668b4cc534989abf1a545fbc83a4c +msgid ":meth:`~.set_align`" +msgstr "" + +#: ../../xml-class.rst:48 13189d407f5646429ad4bdb497fd782c +msgid "Set the alignment using a CSS style spec. Only works for block-level tags." +msgstr "" + +#: ../../xml-class.rst:49 eaa353aac05f45138954419b72b7d4ba +msgid ":meth:`~.set_attribute`" +msgstr "" + +#: ../../xml-class.rst:49 ../../xml-class.rst:172 +#: 7694707920eb4d539cf5b01877a17817 be7383a0b9884dc7a58b0a88ab250831 +msgid "Set an arbitrary key to some value (which may be empty)." +msgstr "" + +#: ../../xml-class.rst:50 aec330afa2e447b9abd5564e2752d291 +msgid ":meth:`~.set_bgcolor`" +msgstr "" + +#: ../../xml-class.rst:50 ../../xml-class.rst:199 +#: 83927f90934c4c199b6056e8267c828c e3a85ba3eba241e9958c4d8c539e2988 +msgid "Set the background color. Only works for block-level tags." +msgstr "" + +#: ../../xml-class.rst:51 80465c34a6e6472f8c0e5b716cf4028a +msgid ":meth:`~.set_bold`" +msgstr "" + +#: ../../xml-class.rst:51 ../../xml-class.rst:205 +#: 65027c4faa4f4b49a121fd45470bd0c1 a5df47b1c16e474d87d0bd875a96b428 +msgid "Set bold on or off or to some string value." +msgstr "" + +#: ../../xml-class.rst:52 2097b02ee66f4d26ae5e9a15016fdd2b +msgid ":meth:`~.set_color`" +msgstr "" + +#: ../../xml-class.rst:52 0cd647181f644b2fa1afa39168cb7841 +msgid "Set text color." +msgstr "" + +#: ../../xml-class.rst:53 f5bcad0277d54c578fa7f23868e43598 +msgid ":meth:`~.set_columns`" +msgstr "" + +#: ../../xml-class.rst:53 6628174199d34501bd798a1b7514ea39 +msgid "Set the number of columns. Argument may be any valid number or string." +msgstr "" + +#: ../../xml-class.rst:54 c36129fb7e8f43d3ac3953a79d12e585 +msgid ":meth:`~.set_font`" +msgstr "" + +#: ../../xml-class.rst:54 067fe7094fa942d28651b6fc30ac5af6 +msgid "Set the font-family, e.g. “sans-serif”." +msgstr "" + +#: ../../xml-class.rst:55 152ee94c6b69440294afdb44afd07574 +msgid ":meth:`~.set_fontsize`" +msgstr "" + +#: ../../xml-class.rst:55 fb7097ec644e4bcf96021aa1b63d5100 +msgid "Set the font size. Either a float or a valid HTML/CSS string." +msgstr "" + +#: ../../xml-class.rst:56 7dbf8f06e6c04d6f81cb6646879ea655 +msgid ":meth:`~.set_id`" +msgstr "" + +#: ../../xml-class.rst:56 831d8653f9e74891b42c08919080eb03 +msgid "Set a :htmlTag:`id`. A check for uniqueness is performed." +msgstr "" + +#: ../../xml-class.rst:57 e66c9843e06f4fb2af39ac3e5c602641 +msgid ":meth:`~.set_italic`" +msgstr "" + +#: ../../xml-class.rst:57 295673b1587049bfaa94904087bab70b +msgid "Set italic on or off or to some string value." +msgstr "" + +#: ../../xml-class.rst:58 04f79bd29ed6451eb82c25ff5cfd658e +msgid ":meth:`~.set_leading`" +msgstr "" + +#: ../../xml-class.rst:58 ../../xml-class.rst:249 +#: 0f11451c0fa4473f93cdbb7b7c191260 5f1d201443024920bda36e91779e8f66 +msgid "" +"Set inter-block text distance (`-mupdf-leading`), only works on block-" +"level nodes." +msgstr "" + +#: ../../xml-class.rst:59 54202c5766164dacb8ef185e17eca21c +msgid ":meth:`~.set_lineheight`" +msgstr "" + +#: ../../xml-class.rst:59 6d92367495594070a6428faa6c60b21f +msgid "Set height of a line. Float like 1.5, which sets to `1.5 * fontsize`." +msgstr "" + +#: ../../xml-class.rst:60 99881d55ddbd43cfb22d0ae80b2ad19a +msgid ":meth:`~.set_margins`" +msgstr "" + +#: ../../xml-class.rst:60 fc010a579e5144f791307253564a323e +msgid "Set the margin(s), float or string with up to 4 values." +msgstr "" + +#: ../../xml-class.rst:61 c6b62eddec3d4bcbb341d38410c0eef3 +msgid ":meth:`~.set_pagebreak_after`" +msgstr "" + +#: ../../xml-class.rst:61 ../../xml-class.rst:267 +#: bba1c4ad73e34f9d9b5f098cb6360f6b cea4b3e17a1a4056b188c870db8d9008 +msgid "Insert a page break after this node." +msgstr "" + +#: ../../xml-class.rst:62 71f10d6c127b4f5c9359b5539440ff1c +msgid ":meth:`~.set_pagebreak_before`" +msgstr "" + +#: ../../xml-class.rst:62 ../../xml-class.rst:271 +#: 4886793c520c4882ac46ea9a852eaa8c 88c0f9c65ca54264a47e63157c802b85 +msgid "Insert a page break before this node." +msgstr "" + +#: ../../xml-class.rst:63 4346fb5e3fe4460ba3e594e143386456 +msgid ":meth:`~.set_properties`" +msgstr "" + +#: ../../xml-class.rst:63 aa2e4fd67e8547f59e073acbcba88996 +msgid "Set any or all desired properties in one call." +msgstr "" + +#: ../../xml-class.rst:64 07a96d1446c14e6b9e5df90373fa153e +msgid ":meth:`~.add_style`" +msgstr "" + +#: ../../xml-class.rst:64 b9e751681f344ddb883642ade3b86c23 +msgid "Set (add) a “style” that is not supported by its own `set_` method." +msgstr "" + +#: ../../xml-class.rst:65 2d813714a59846efaeae5ee61a647adc +msgid ":meth:`~.add_class`" +msgstr "" + +#: ../../xml-class.rst:65 0f0e3d2e96f044ffbc77371775da4387 +msgid "Set (add) a “class” attribute." +msgstr "" + +#: ../../xml-class.rst:66 80b140b07f884b6c8305085f42c31c1a +msgid ":meth:`~.set_text_indent`" +msgstr "" + +#: ../../xml-class.rst:66 fba08fbff95c4bcdb14f15ad45daea1c +msgid "" +"Set indentation for first textblock line. Only works for block-level " +"nodes." +msgstr "" + +#: ../../xml-class.rst:67 9e8c0b8813c94951ba33f31a9c07d29e +msgid ":attr:`~.tagname`" +msgstr "" + +#: ../../xml-class.rst:67 ../../xml-class.rst:370 +#: 43c2b30ba5d84ab29727bad41d1e566b aa9f7ddb186d4e8e9edcd90ec5ead9f5 +msgid "Either the HTML tag name like :htmlTag:`p` or `None` if a text node." +msgstr "" + +#: ../../xml-class.rst:68 28426a971716405095f3ffdc6c429972 +msgid ":attr:`~.text`" +msgstr "" + +#: ../../xml-class.rst:68 ../../xml-class.rst:374 +#: 0b162ef737e24c7cb15ce82a36b1ee16 30398bcad9ec4b559558f3cff6d83fc3 +msgid "Either the node's text or `None` if a tag node." +msgstr "" + +#: ../../xml-class.rst:69 0068e016dfef4941b4ca3beed58cd353 +msgid ":attr:`~.is_text`" +msgstr "" + +#: ../../xml-class.rst:69 961764d8983043da8cba3bed5dcc4ddc +msgid "Check if the node is a text." +msgstr "" + +#: ../../xml-class.rst:70 388c98eba6394e32a6ca3706645e9e67 +msgid ":attr:`~.first_child`" +msgstr "" + +#: ../../xml-class.rst:70 ../../xml-class.rst:382 +#: 0a64f624aa5c4769b7941f5cab7d338d 2751e0a950694e9e99316d8a2d60944d +msgid "Contains the first node one level below this one (or `None`)." +msgstr "" + +#: ../../xml-class.rst:71 211ddec4fa16438fa6f21a342ad96ac1 +msgid ":attr:`~.last_child`" +msgstr "" + +#: ../../xml-class.rst:71 ../../xml-class.rst:386 +#: 29b0abf22c824089b9275c6d4bda9bf3 8b610745ccba4a2aab3964693bd7eff6 +msgid "Contains the last node one level below this one (or `None`)." +msgstr "" + +#: ../../xml-class.rst:72 e9c0bc11a6db487cb74ea12bec4f2584 +msgid ":attr:`~.next`" +msgstr "" + +#: ../../xml-class.rst:72 ../../xml-class.rst:390 +#: 0b752a41d94b4229b2bf542a37f28101 835b4afd51424261b8e0f22194ee6299 +msgid "The next node at the same level (or `None`)." +msgstr "" + +#: ../../xml-class.rst:73 4d5e7cc28ff54112a6da281310de34c1 +msgid ":attr:`~.previous`" +msgstr "" + +#: ../../xml-class.rst:73 ../../xml-class.rst:394 +#: 9e206c3347744eb09f8ff330d683a62b af4548edae514d78b3766605a77c3f92 +msgid "The previous node at the same level." +msgstr "" + +#: ../../xml-class.rst:74 98aca4848c624d11ad0d3fbb13b1dc40 +msgid ":attr:`~.root`" +msgstr "" + +#: ../../xml-class.rst:74 ../../xml-class.rst:398 +#: 7433e844b74c4df3ab683593b3ed5236 a7a32ee2a5874804be24453efe5f5345 +msgid "The top node of the DOM, which hence has the tagname :htmlTag:`html`." +msgstr "" + +#: ../../xml-class.rst:79 02e904731a734003b24117abb1fa24c2 +msgid "**Class API**" +msgstr "" + +#: ../../xml-class.rst:85 ec48c5ffbd184826b0d42085c9cd7370 +msgid "" +"Add an :htmlTag:`ul` tag - bulleted list, context manager. See `ul " +"`_." +msgstr "" + +#: ../../xml-class.rst:89 e55c37e0b9f147bdbfe7d5de649ed3bb +msgid "" +"Add a :htmlTag:`pre` tag, context manager. See `pre " +"`_." +msgstr "" + +#: ../../xml-class.rst:93 7ccf91624b6140b29292dc53daa301a8 +msgid "" +"Add a :htmlTag:`dl` tag, context manager. See `dl " +"`_." +msgstr "" + +#: ../../xml-class.rst:97 f8f5c2f281d1458f94a92637cfc212b9 +msgid "" +"Add a :htmlTag:`div` tag, context manager. See `div " +"`_." +msgstr "" + +#: ../../xml-class.rst:101 f5d50e3c509c4f17b42e24ed990c935e +msgid "" +"Add a header tag (one of :htmlTag:`h1` to :htmlTag:`h6`), context " +"manager. See `headings `_." +msgstr "" + +#: ../../xml-class.rst 01526ca2338f4089b232661f32ce0d26 +#: 01605f7591b64cc0a8c58c4bf0728c50 0ddec4e1f19e4d1c97fa26e0f7aa6a7a +#: 11e689241e5d4759be0a3aa011abd345 224a0dc715e345b0b48c35aeb3179fbf +#: 24110c01bd7e4306bee7559d81179d9e 2f03e65e9d56405894c35b3f2c15cc49 +#: 3903ce7a0309491abc61a2e60104bb0f 42fa8a09bdc343c9b845ec419721c396 +#: 4806b09fbbe140d9a9f34abf626c220f 4f2316dd72184a18bfe1f60741093fba +#: 545ab6816f374b3398963719cdff2c2d 572a28ca46334b5cb144e6311efdda1c +#: 65b3c0c9581f4bcfbf9b2f72568f61d2 6696b584d5af4254b67117d47d067f68 +#: 6a12e8e107af479f95b57a00f40d228c 6ee1ede4325c42bcbcd7743537f483df +#: 7351aba3c9d446e3a6fcd1106d9c63bf 748da71d9db147a5833e9fc9f6cd9a46 +#: 885e44a575dd4b29bb68e3ffa286a026 940090a1314948ada850811baf78d00b +#: a1577c82a7164538aeb15149af70204b ac6c945b900a4607aa5916e1a7d73438 +#: c8a6006bf8994e40b89c8f39833984e6 cd19ffc65b6a47c0a41b2f5019d7c122 +#: f27836a1c99d4e8b9b5f32c8f5770492 fac138ba72d149b4b3131fee17d07292 +msgid "Parameters" +msgstr "" + +#: ../../xml-class.rst:103 78bbf5f830804cf0a6273b119a52ec85 +msgid "a value 1 - 6." +msgstr "" + +#: ../../xml-class.rst:107 c1b7588052ce48a5874a9f699427c484 +msgid "" +"Add a :htmlTag:`hr` tag. See `hr `_." +msgstr "" + +#: ../../xml-class.rst:111 76a40de312e2495da16909bf8199a56e +msgid "" +"Add an :htmlTag:`img` tag. This causes the inclusion of the named image " +"in the DOM." +msgstr "" + +#: ../../xml-class.rst:113 82b4dae48e2548f2a659dbb747df037f +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 "" + +#: ../../xml-class.rst:114 6446f8d32bc5468aa5666f58502bf4b4 +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 "" + +#: ../../xml-class.rst:115 f28760fb9d664475b68c1f1693efe30f +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 "" + +#: ../../xml-class.rst:119 c724fbd5af1f4b189e460fb456eb6caa +msgid "Add an :htmlTag:`a` tag - inline element, treated like text." +msgstr "" + +#: ../../xml-class.rst:121 b0af62f8cb71413ea8217b382e0865ec +msgid "the URL target." +msgstr "" + +#: ../../xml-class.rst:122 43fcacd9259b4c32a8ed0a13a3c90e73 +msgid "the text to display. If omitted, the `href` text is shown instead." +msgstr "" + +#: ../../xml-class.rst:126 cc7469e467184555a7e74aec23257849 +msgid "Add an :htmlTag:`ol` tag, context manager." +msgstr "" + +#: ../../xml-class.rst:130 f62ddc016ccb469aad2b36b90b0e9e2f +msgid "Add a :htmlTag:`p` tag, context manager." +msgstr "" + +#: ../../xml-class.rst:134 ff10c502f43040edaec43e968cc00966 +msgid "Add a :htmlTag:`span` tag, context manager. See `span`_" +msgstr "" + +#: ../../xml-class.rst:138 a7f4402db19b4ced94c63931a93ea6e9 +msgid "" +"Add \"subscript\" text(:htmlTag:`sub` tag) - inline element, treated like" +" text." +msgstr "" + +#: ../../xml-class.rst:142 a87f4207b22b45feab8b43a6281e4e3e +msgid "" +"Add \"superscript\" text (:htmlTag:`sup` tag) - inline element, treated " +"like text." +msgstr "" + +#: ../../xml-class.rst:146 8592491edf47422994ae0db8adb19653 +msgid "" +"Add \"code\" text (:htmlTag:`code` tag) - inline element, treated like " +"text." +msgstr "" + +#: ../../xml-class.rst:150 3c73b10b021f4722ade5a6fcef716987 +msgid "" +"Add \"variable\" text (:htmlTag:`var` tag) - inline element, treated like" +" text." +msgstr "" + +#: ../../xml-class.rst:154 65f64d2d93aa49f2a5775594056d17f5 +msgid "" +"Add \"sample output\" text (:htmlTag:`samp` tag) - inline element, " +"treated like text." +msgstr "" + +#: ../../xml-class.rst:158 8d95a809d1124df6b391faf29e018d39 +msgid "" +"Add \"keyboard input\" text (:htmlTag:`kbd` tag) - inline element, " +"treated like text." +msgstr "" + +#: ../../xml-class.rst:166 a840fc8903e74e7db10acc78d1235df3 +msgid "Set the text alignment. Only works for block-level tags." +msgstr "" + +#: ../../xml-class.rst:168 6f98f6eed0144c7a94f9b408f231acc3 +msgid "" +"either one of the :ref:`TextAlign` or the `text-align " +"`_ values." +msgstr "" + +#: ../../xml-class.rst:174 ../../xml-class.rst:187 ../../xml-class.rst:195 +#: 8104ae7a6e9c42c387107e9ad3ade43d cf302e2a42cc43c391b9697764e992fc +#: f07926f5a6344b1e827240f422a8c137 +msgid "the name of the attribute." +msgstr "" + +#: ../../xml-class.rst:175 9f22554eb8e64426ae63bcb86023e4d8 +msgid "the (optional) value of the attribute." +msgstr "" + +#: ../../xml-class.rst:179 29ff3209b9384b8b8a5be4e967f55764 +msgid "Retrieve all attributes of the current nodes as a dictionary." +msgstr "" + +#: ../../xml-class.rst 16240a0c06794ef0ab61cc35f8fba124 +#: 3880374cdd264171bdfecb7f58d692e1 55ece4fa5e2b4524b193373be37d8581 +#: 631b30e0e6fb448b95deaaee259b4749 b5f5bfec9749472b9999c4b0882a86e5 +#: b6acd981026c464eb513adcd782c8ec1 e84b8eaf8bba4d11b41482984e8c4acf +msgid "Returns" +msgstr "" + +#: ../../xml-class.rst:181 5d869ba5b22c4f9580be45427fbf0a25 +msgid "a dictionary with the attributes and their values of the node." +msgstr "" + +#: ../../xml-class.rst:185 3af90a3d2ba44bbb9e35032e8782efec +msgid "Get the attribute value of `key`." +msgstr "" + +#: ../../xml-class.rst:189 cb8e96dd235e41beaef229dc76c4efd5 +msgid "a string with the value of `key`." +msgstr "" + +#: ../../xml-class.rst:193 716655c33b75499c80b25c2be25e66e9 +msgid "Remove the attribute `key` from the node." +msgstr "" + +#: ../../xml-class.rst:201 2cc462e2caf849cba8f17be3083851f5 +msgid "" +"either an RGB value like (255, 0, 0) (for \"red\") or a valid " +"`background-color `_ value." +msgstr "" + +#: ../../xml-class.rst:207 73200a30423c42fc81ccfa043ea42e08 +msgid "" +"`True`, `False` or a valid `font-weight `_ value." +msgstr "" + +#: ../../xml-class.rst:211 8fc3c9c24b8a48d2b6d81867c8fe8e0e +msgid "Set the color of the text following." +msgstr "" + +#: ../../xml-class.rst:213 63b799d8ea084ae7b8fd1b93a1fe539b +msgid "" +"either an RGB value like (255, 0, 0) (for \"red\") or a valid `color " +"`_ value." +msgstr "" + +#: ../../xml-class.rst:217 a90c8b36e8f24bc0b89544c3c41bd5d0 +msgid "Set the number of columns." +msgstr "" + +#: ../../xml-class.rst:219 9902e7494ec8408a9632870f728d86b6 +msgid "" +"a valid `columns `_ value." +msgstr "" + +#: ../../xml-class.rst:221 bc6b0e32045c4ba789bd0e2b06796a83 +msgid "Currently ignored - supported in a future MuPDF version." +msgstr "" + +#: ../../xml-class.rst:225 dd592f017d0642c8a374c1d4b60c1a5f +msgid "Set the font-family." +msgstr "" + +#: ../../xml-class.rst:227 cc88b5baf82440f9a3b43a445f8cc6f1 +msgid "e.g. \"sans-serif\"." +msgstr "" + +#: ../../xml-class.rst:231 6799045fc7c14b889a25e1e5bced855d +msgid "Set the font size for text following." +msgstr "" + +#: ../../xml-class.rst:233 1430594c22854efbb843cca397f846c8 +msgid "" +"a float or a valid `font-size `_ value." +msgstr "" + +#: ../../xml-class.rst:237 3f8c11b2201f4f05b7dbf1d003363d2d +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 "" + +#: ../../xml-class.rst:239 c19568457d8b405dbf6d731619d54f5d +msgid "id string of the node." +msgstr "" + +#: ../../xml-class.rst:243 cd7baa0661a34af08cd8ff33d10afebd +msgid "Set italic on or off or to some string value for the text following it." +msgstr "" + +#: ../../xml-class.rst:245 e8af9175ab9e4fd9810836529908275d +msgid "" +"`True`, `False` or some valid `font-style `_ value." +msgstr "" + +#: ../../xml-class.rst:251 94ee1e7561e24ecdbb0af64cc066a2b1 +msgid "the distance in points to the previous block." +msgstr "" + +#: ../../xml-class.rst:255 86f271e54150486597e5f38fe3849244 +msgid "Set height of a line." +msgstr "" + +#: ../../xml-class.rst:257 63143938f9d049619965088b3a062989 +msgid "" +"a float like 1.5 (which sets to `1.5 * fontsize`), or some valid `line-" +"height `_ " +"value." +msgstr "" + +#: ../../xml-class.rst:261 c00da9cda1024f8591f901f7ca3590e8 +msgid "Set the margin(s)." +msgstr "" + +#: ../../xml-class.rst:263 8428b75afab14d3d8037829a4c273dc1 +msgid "" +"float or string with up to 4 values. See `CSS documentation " +"`_." +msgstr "" + +#: ../../xml-class.rst:275 9f60e6552dda49ac92f6c8b24e8bd0e7 +msgid "" +"Set any or all desired properties in one call. The meaning of argument " +"values equal the values of the corresponding `set_` methods." +msgstr "" + +#: ../../xml-class.rst:277 3068b42e933145a9bfb65afa9a448149 +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 "" + +#: ../../xml-class.rst:281 21ef9b888cf94bb3905686ea51b4deff +msgid "Set (add) some style attribute not supported by its own `set_` method." +msgstr "" + +#: ../../xml-class.rst:283 05a59a9ae9fb4fc8a9a1b374a3bc92ae +msgid "any valid CSS style value." +msgstr "" + +#: ../../xml-class.rst:287 6db7b3bb6cec4529bae8a06825f38a8c +msgid "Set (add) some \"class\" attribute." +msgstr "" + +#: ../../xml-class.rst:289 d8a46805c6b348399fe3d275602cfb66 +msgid "" +"the name of the class. Must have been defined in either the HTML or the " +"CSS source of the DOM." +msgstr "" + +#: ../../xml-class.rst:293 544c15505475487aa84c86c178f8158d +msgid "" +"Set indentation for the first textblock line. Only works for block-level " +"nodes." +msgstr "" + +#: ../../xml-class.rst:295 6cfa81414b8b443eb12103a11e271500 +msgid "" +"a valid `text-indent `_ value. Please note that negative values do not work." +msgstr "" + +#: ../../xml-class.rst:300 f794104b53d2457dbe8dda77d237ba22 +msgid "" +"Append a child node. This is a low-level method used by other methods " +"like :meth:`Xml.add_paragraph`." +msgstr "" + +#: ../../xml-class.rst:302 56e4572fbb56478b8a269a0c3c2cc837 +msgid "the :ref:`Xml` node to append." +msgstr "" + +#: ../../xml-class.rst:308 4b9adbefc1c9445cb1722d22a6b35e62 +msgid "the text to append." +msgstr "" + +#: ../../xml-class.rst 1cc5b68191634c26a9187b132a8b2185 +#: 5a103b1d08ea47fe86c481d76a15c917 73c49d739608415f9546ce830c7c0207 +#: d4f3f1ca7de748828485ec4adb70a760 +msgid "Return type" +msgstr "" + +#: ../../xml-class.rst:310 ../../xml-class.rst:319 +#: d6202836d8974fda847962bc298fa305 efb70a8a4ec645f5a0364256add892c1 +msgid ":ref:`Xml`" +msgstr "" + +#: ../../xml-class.rst:311 bd9c79ef0b11458989eda5820b43f878 +msgid "the created element." +msgstr "" + +#: ../../xml-class.rst:315 12c491e2bca846489fb32c7251dcb277 +msgid "" +"Create a new node with a given tag. This a low-level method used by other" +" methods like :meth:`Xml.add_paragraph`." +msgstr "" + +#: ../../xml-class.rst:317 c1ec127a7f07484fb8e758ef9a3823b4 +msgid "the element tag." +msgstr "" + +#: ../../xml-class.rst:320 2ec1bb99aef04cab975ec9e1db9b2c7d +msgid "" +"the created element. To actually bind it to the DOM, use " +":meth:`Xml.append_child`." +msgstr "" + +#: ../../xml-class.rst:324 76509e6633be4e39aa0d4812db8c1a98 +msgid "Insert the given element `elem` before this node." +msgstr "" + +#: ../../xml-class.rst:326 ../../xml-class.rst:332 +#: 204d321505a341e0b7be67e9612a8658 59c66cc235d34564a949b819ddd4a2b3 +msgid "some :ref:`Xml` element." +msgstr "" + +#: ../../xml-class.rst:330 cf63429029884bc8a865a8d732a00890 +msgid "Insert the given element `elem` after this node." +msgstr "" + +#: ../../xml-class.rst:336 5a495023e1cc4ce2ba688743983cf628 +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 "" + +#: ../../xml-class.rst:338 111c68910ba04867abb7d7ddd929143b +msgid "the clone (:ref:`Xml`) of the current node." +msgstr "" + +#: ../../xml-class.rst:342 975380ec707d4f8a92336e121074df6e +msgid "Remove this node from the DOM." +msgstr "" + +#: ../../xml-class.rst:347 34efd6a602a642f69800239cb219b61a +msgid "For debugging purposes, print this node's structure in a simplified form." +msgstr "" + +#: ../../xml-class.rst:351 308c34c3fa894f738fbec8a78ccbee8f +msgid "" +"Under the current node, find the first node with the given `tag`, " +"attribute `att` and value `match`." +msgstr "" + +#: ../../xml-class.rst:353 ff6cb4df87454f0ab5315565598d565d +msgid "restrict search to this tag. May be `None` for unrestricted searches." +msgstr "" + +#: ../../xml-class.rst:354 59c76ba0cbb943a0a1a2e912b7142730 +msgid "check this attribute. May be `None`." +msgstr "" + +#: ../../xml-class.rst:355 0558d41ef8d84440a41fc24f30fd9f32 +msgid "the desired attribute value to match. May be `None`." +msgstr "" + +#: ../../xml-class.rst:357 ../../xml-class.rst:364 +#: 0577c5de8fee491f80629c1a43949e0b f2643aaf01a14289bec902c9ce070912 +msgid ":ref:`Xml`." +msgstr "" + +#: ../../xml-class.rst:358 6cce02a1baee4b8e85f53c00fad2b246 +msgid "`None` if nothing found, otherwise the first matching node." +msgstr "" + +#: ../../xml-class.rst:362 551bbf3605e04049a695632ef7d8270f +msgid "" +"Continue a previous :meth:`Xml.find` (or ::meth:`find_next`) with the " +"same values." +msgstr "" + +#: ../../xml-class.rst:365 2346f5ac56344cdf9cc1e910508fe33e +msgid "`None` if none more found, otherwise the next matching node." +msgstr "" + +#: ../../xml-class.rst:378 cfeed378fd044bbf9bf3fc7fc0a9e145 +msgid "Check if a text node." +msgstr "" + +#: ../../xml-class.rst:402 578e54b1d8904c92856beb712748d695 +msgid "Setting Text properties" +msgstr "" + +#: ../../xml-class.rst:404 2152e432122c403dacfafb1e5c00b3fc +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 "" + +#: ../../xml-class.rst:406 7ff8bf69f9c2454b9d06df1b62c116b6 +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 "" + +#: ../../xml-class.rst:408 8cb35716465e48d7acb82226506518b1 +msgid "" +"In addition, these methods return there parent node, so they can be " +"concatenated with each other." +msgstr "" + +#: ../../xml-class.rst:413 0890e1378b2f4d9d9a5dd8f0c690772c +msgid "Context Manager support" +msgstr "" + +#: ../../xml-class.rst:414 10d8113dac5d4653bf8e79db50ec32da +msgid "The standard way to add nodes to a DOM is this::" +msgstr "" + +#: ../../xml-class.rst:427 42b90014c2dd4f1388497265d978f101 +msgid "" +"Methods that are flagged as \"context managers\" can conveniently be used" +" in this way::" +msgstr "" + +#: ../../footer.rst:-1 34409be9317344669302526a11781e50 +msgid "Discord logo" +msgstr "" + diff --git a/docs/locales/ja/LC_MESSAGES/znames.mo b/docs/locales/ja/LC_MESSAGES/znames.mo new file mode 100644 index 000000000..60494690f Binary files /dev/null and b/docs/locales/ja/LC_MESSAGES/znames.mo differ diff --git a/docs/locales/ja/LC_MESSAGES/znames.po b/docs/locales/ja/LC_MESSAGES/znames.po new file mode 100644 index 000000000..ed974f75b --- /dev/null +++ b/docs/locales/ja/LC_MESSAGES/znames.po @@ -0,0 +1,965 @@ +# 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" + +#: ../../znames.rst:7 3b8e03075de74bc29357d3db6ab39e2f +msgid "Deprecated Names" +msgstr "非推奨の名前" + +#: ../../znames.rst:9 62a32e927a01467aab597164c40ce8e3 +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 fa9d3f3d0806482eae8f9af6429d15d2 +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 fb628e5d1cbc4cf69a354946006c9efb +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 946a90871d6f48229e4c2ba5c32f8eb1 +msgid "" +"Names of classes (camel case) and package-wide constants (the majority is" +" upper case) remain untouched." +msgstr "クラスの名前（キャメルケース）やパッケージ全体の定数（大部分は大文字）については、触れずに残ります。" + +#: ../../znames.rst:18 d7268acc0e784d7ba363e25e317a166c +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 5dcd7a58709d4e72b78a6f33ce986446 +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 42008974adc641b596eabce0be0349a6 +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 06da040c5ab6428f85f46e09a378819d +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ファイルおよびそのサブフォルダのファイルが変更されます。必要に応じて、スクリプトのバックアップを取ることもできます。" + +#: ../../znames.rst:41 ff31e4c3bd904201a0cb6860aa0bb409 +msgid "" +"Deprecated names are not separately documented. The following list will " +"help you find the documentation of the original." +msgstr "非推奨の名前は別途文書化されていません。以下のリストは、元のドキュメントの検索に役立ちます。" + +#: ../../znames.rst:43 46e111e6912f4acfbb3ad463b03beaca +msgid "" +"This is automatically generated. One or two items refer to yet " +"undocumented methods - please simply ignore them." +msgstr "これは自動的に生成されたものです。1または2のアイテムはまだ文書化されていないメソッドを参照していますが、無視してください。" + +#: ../../deprecated.rst:3 b11e52513d464ff2a753f460c9df2a70 +msgid ":index:`_isWrapped` -- :attr:`Page.is_wrapped`" +msgstr "" + +#: ../../deprecated.rst:4 6bb8f9eea690444d9b9d4506673a096a +msgid ":index:`addCaretAnnot` -- :meth:`Page.add_caret_annot`" +msgstr "" + +#: ../../deprecated.rst:5 388457daa28c420b9897b88484156010 +msgid ":index:`addCircleAnnot` -- :meth:`Page.add_circle_annot`" +msgstr "" + +#: ../../deprecated.rst:6 c918665634154010a296f7b0e98ef281 +msgid ":index:`addFileAnnot` -- :meth:`Page.add_file_annot`" +msgstr "" + +#: ../../deprecated.rst:7 4afca843e72f47e599f74ee1d35096d3 +msgid ":index:`addFreetextAnnot` -- :meth:`Page.add_freetext_annot`" +msgstr "" + +#: ../../deprecated.rst:8 2e61ba13af6245ecb55f48a5f96dca75 +msgid ":index:`addHighlightAnnot` -- :meth:`Page.add_highlight_annot`" +msgstr "" + +#: ../../deprecated.rst:9 da49b410542f409e992f6779c66f1d24 +msgid ":index:`addInkAnnot` -- :meth:`Page.add_ink_annot`" +msgstr "" + +#: ../../deprecated.rst:10 fd0fa7eca59c4367ade7bbe6d6bae2e8 +msgid ":index:`addLineAnnot` -- :meth:`Page.add_line_annot`" +msgstr "" + +#: ../../deprecated.rst:11 28866a379bf6487eb72ed8276419ac2b +msgid ":index:`addPolygonAnnot` -- :meth:`Page.add_polygon_annot`" +msgstr "" + +#: ../../deprecated.rst:12 a099f3a5d77d4682825e52fe7781faf7 +msgid ":index:`addPolylineAnnot` -- :meth:`Page.add_polyline_annot`" +msgstr "" + +#: ../../deprecated.rst:13 36d2ac6a811e498ca22956a8dc11f608 +msgid ":index:`addRectAnnot` -- :meth:`Page.add_rect_annot`" +msgstr "" + +#: ../../deprecated.rst:14 713c3be36ec546eba9ee65ff50c10ad7 +msgid ":index:`addRedactAnnot` -- :meth:`Page.add_redact_annot`" +msgstr "" + +#: ../../deprecated.rst:15 edcaa691cb0b4e2aa2aa2ed92a2744fd +msgid ":index:`addSquigglyAnnot` -- :meth:`Page.add_squiggly_annot`" +msgstr "" + +#: ../../deprecated.rst:16 5eba9bbfa2604c30868a6083e4d76599 +msgid ":index:`addStampAnnot` -- :meth:`Page.add_stamp_annot`" +msgstr "" + +#: ../../deprecated.rst:17 35a699dd04754eab959b8d3dfeb20032 +msgid ":index:`addStrikeoutAnnot` -- :meth:`Page.add_strikeout_annot`" +msgstr "" + +#: ../../deprecated.rst:18 dc89fbb4045b494981da264cd32d132c +msgid ":index:`addTextAnnot` -- :meth:`Page.add_text_annot`" +msgstr "" + +#: ../../deprecated.rst:19 0479147da68249da92888d045ef97236 +msgid ":index:`addUnderlineAnnot` -- :meth:`Page.add_underline_annot`" +msgstr "" + +#: ../../deprecated.rst:20 4e05e847b3774eeda58b76cf6aeeadb2 +msgid ":index:`addWidget` -- :meth:`Page.add_widget`" +msgstr "" + +#: ../../deprecated.rst:21 e7fe24bd068c466196cfb7b383668278 +msgid ":index:`chapterCount` -- :attr:`Document.chapter_count`" +msgstr "" + +#: ../../deprecated.rst:22 63cf9d007abb421eaf231290090024f6 +msgid ":index:`chapterPageCount` -- :meth:`Document.chapter_page_count`" +msgstr "" + +#: ../../deprecated.rst:23 f2937b03b70a4325b01685aee5112c8c +msgid ":index:`cleanContents` -- :meth:`Page.clean_contents`" +msgstr "" + +#: ../../deprecated.rst:24 658e471705a644aca8b8c8b008435531 +msgid ":index:`clearWith` -- :meth:`Pixmap.clear_with`" +msgstr "" + +#: ../../deprecated.rst:25 e069d91b20764b4da04c573e7acd0a54 +msgid ":index:`convertToPDF` -- :meth:`Document.convert_to_pdf`" +msgstr "" + +#: ../../deprecated.rst:26 5c9b3c7be07940bbb9d51ae0187765f6 +msgid ":index:`copyPage` -- :meth:`Document.copy_page`" +msgstr "" + +#: ../../deprecated.rst:27 fda65ad8042f4eac9b60ea461f15f657 +msgid ":index:`copyPixmap` -- :meth:`Pixmap.copy`" +msgstr "" + +#: ../../deprecated.rst:28 bc01a34a77dc415791c8b611076e2f74 +msgid ":index:`CropBox` -- :attr:`Page.cropbox`" +msgstr "" + +#: ../../deprecated.rst:29 477b00ede9e440ec8fead7f59f1065a3 +msgid ":index:`CropBoxPosition` -- :attr:`Page.cropbox_position`" +msgstr "" + +#: ../../deprecated.rst:30 cbd7c37aca1445cebf8cc9ea4dd6d604 +msgid ":index:`deleteAnnot` -- :meth:`Page.delete_annot`" +msgstr "" + +#: ../../deprecated.rst:31 ddbf2717908e43fd86adc4ed6658a249 +msgid ":index:`deleteLink` -- :meth:`Page.delete_link`" +msgstr "" + +#: ../../deprecated.rst:32 4661bb2f336443838ec25c18708d19f0 +msgid ":index:`deletePage` -- :meth:`Document.delete_page`" +msgstr "" + +#: ../../deprecated.rst:33 6fdb07e88cda437cb632856e056d2f7d +msgid ":index:`deletePageRange` -- :meth:`Document.delete_pages`" +msgstr "" + +#: ../../deprecated.rst:34 5b4c6c69e79d4a86b28f92d22c67af93 +msgid ":index:`deleteWidget` -- :meth:`Page.delete_widget`" +msgstr "" + +#: ../../deprecated.rst:35 37e2f65cd0f548cfbfe7e0527c92def1 +msgid ":index:`derotationMatrix` -- :attr:`Page.derotation_matrix`" +msgstr "" + +#: ../../deprecated.rst:36 a4b58109568c432b92cbb9addab999e6 +msgid ":index:`drawBezier` -- :meth:`Page.draw_bezier`" +msgstr "" + +#: ../../deprecated.rst:37 bf04aca7c6954037ad88933b6f5c2270 +msgid ":index:`drawBezier` -- :meth:`Shape.draw_bezier`" +msgstr "" + +#: ../../deprecated.rst:38 8daffedb9d6a44428f30b2d8b0f2ce6c +msgid ":index:`drawCircle` -- :meth:`Page.draw_circle`" +msgstr "" + +#: ../../deprecated.rst:39 ac9cc92f21914db2bb93747dfbe68e48 +msgid ":index:`drawCircle` -- :meth:`Shape.draw_circle`" +msgstr "" + +#: ../../deprecated.rst:40 28cab423f0fd43e8939bd3408a72e182 +msgid ":index:`drawCurve` -- :meth:`Page.draw_curve`" +msgstr "" + +#: ../../deprecated.rst:41 e6ba2832d21c4175afb761a536eae5a1 +msgid ":index:`drawCurve` -- :meth:`Shape.draw_curve`" +msgstr "" + +#: ../../deprecated.rst:42 19a045ffac7e468fb91d6e1898eff462 +msgid ":index:`drawLine` -- :meth:`Page.draw_line`" +msgstr "" + +#: ../../deprecated.rst:43 90aae4ea14494a3b9e1ce79458e66317 +msgid ":index:`drawLine` -- :meth:`Shape.draw_line`" +msgstr "" + +#: ../../deprecated.rst:44 343abf010f004657a89e1536fa226d93 +msgid ":index:`drawOval` -- :meth:`Page.draw_oval`" +msgstr "" + +#: ../../deprecated.rst:45 6b38f991daef4510af4ad4abb51d9777 +msgid ":index:`drawOval` -- :meth:`Shape.draw_oval`" +msgstr "" + +#: ../../deprecated.rst:46 99175092498f435f8d947c7779c2982b +msgid ":index:`drawPolyline` -- :meth:`Page.draw_polyline`" +msgstr "" + +#: ../../deprecated.rst:47 a68894e60b59442db415f2a6afca71cb +msgid ":index:`drawPolyline` -- :meth:`Shape.draw_polyline`" +msgstr "" + +#: ../../deprecated.rst:48 a158c86940484252a6c017602bb9098e +msgid ":index:`drawQuad` -- :meth:`Page.draw_quad`" +msgstr "" + +#: ../../deprecated.rst:49 2d12b5f28fb14ab789452a508699f93d +msgid ":index:`drawQuad` -- :meth:`Shape.draw_quad`" +msgstr "" + +#: ../../deprecated.rst:50 8cfb0816b1054e2182833047fb18ca63 +msgid ":index:`drawRect` -- :meth:`Page.draw_rect`" +msgstr "" + +#: ../../deprecated.rst:51 0c122478220a496181171407ab665ab3 +msgid ":index:`drawRect` -- :meth:`Shape.draw_rect`" +msgstr "" + +#: ../../deprecated.rst:52 a2d2a81f4ba64578b73b4616f69cfb5b +msgid ":index:`drawSector` -- :meth:`Page.draw_sector`" +msgstr "" + +#: ../../deprecated.rst:53 699ed3fb915d4876bd9dc156010fcf83 +msgid ":index:`drawSector` -- :meth:`Shape.draw_sector`" +msgstr "" + +#: ../../deprecated.rst:54 edf0119c583845f6bfd953c836b49980 +msgid ":index:`drawSquiggle` -- :meth:`Page.draw_squiggle`" +msgstr "" + +#: ../../deprecated.rst:55 96f1f1d5f0304763a3ba0b0580d39908 +msgid ":index:`drawSquiggle` -- :meth:`Shape.draw_squiggle`" +msgstr "" + +#: ../../deprecated.rst:56 807a6c96970b42daa85e671ee10a7d08 +msgid ":index:`drawZigzag` -- :meth:`Page.draw_zigzag`" +msgstr "" + +#: ../../deprecated.rst:57 cb6d688d7a3445a193f3324017ed280f +msgid ":index:`drawZigzag` -- :meth:`Shape.draw_zigzag`" +msgstr "" + +#: ../../deprecated.rst:58 33bb4579c4b44fe899e0852cfe9fa99c +msgid ":index:`embeddedFileAdd` -- :meth:`Document.embfile_add`" +msgstr "" + +#: ../../deprecated.rst:59 24b2f7f98aeb4f42b6ef59cc443b5fd3 +msgid ":index:`embeddedFileCount` -- :meth:`Document.embfile_count`" +msgstr "" + +#: ../../deprecated.rst:60 07d5d3556c144d7390980a6ce0418701 +msgid ":index:`embeddedFileDel` -- :meth:`Document.embfile_del`" +msgstr "" + +#: ../../deprecated.rst:61 4ce88670afab4e478b181acc135f7db2 +msgid ":index:`embeddedFileGet` -- :meth:`Document.embfile_get`" +msgstr "" + +#: ../../deprecated.rst:62 a9d15a81c86b4dae9856f930f2b5315c +msgid ":index:`embeddedFileInfo` -- :meth:`Document.embfile_info`" +msgstr "" + +#: ../../deprecated.rst:63 7c22765bf7a24073b18f3883a7afe611 +msgid ":index:`embeddedFileNames` -- :meth:`Document.embfile_names`" +msgstr "" + +#: ../../deprecated.rst:64 6bb7c9c36fdc4cb2ac992d37ffdfbc12 +msgid ":index:`embeddedFileUpd` -- :meth:`Document.embfile_upd`" +msgstr "" + +#: ../../deprecated.rst:65 aa178953eac7424ebf438d0780e0f822 +msgid ":index:`extractFont` -- :meth:`Document.extract_font`" +msgstr "" + +#: ../../deprecated.rst:66 cf719dfc1a6c4e3c8d26813edc1f08e0 +msgid ":index:`extractImage` -- :meth:`Document.extract_image`" +msgstr "" + +#: ../../deprecated.rst:67 944b66eb46bb44debbbcd2dbc321c2a3 +msgid ":index:`fileGet` -- :meth:`Annot.get_file`" +msgstr "" + +#: ../../deprecated.rst:68 8326a763f63b41c3b4480e4ccf23e843 +msgid ":index:`fileUpd` -- :meth:`Annot.update_file`" +msgstr "" + +#: ../../deprecated.rst:69 dbe30932dcba40d7aa939501f229ed50 +msgid ":index:`fillTextbox` -- :meth:`TextWriter.fill_textbox`" +msgstr "" + +#: ../../deprecated.rst:70 65ac7263ac134ff4b33d426821a2a510 +msgid ":index:`findBookmark` -- :meth:`Document.find_bookmark`" +msgstr "" + +#: ../../deprecated.rst:71 fd9e2988392d4fb1a008b3309781f2b1 +msgid ":index:`firstAnnot` -- :attr:`Page.first_annot`" +msgstr "" + +#: ../../deprecated.rst:72 86a32d01fc5642628a0350d5cb8c5b18 +msgid ":index:`firstLink` -- :attr:`Page.first_link`" +msgstr "" + +#: ../../deprecated.rst:73 072a70ffcf2446368a0beef92b9f8879 +msgid ":index:`firstWidget` -- :attr:`Page.first_widget`" +msgstr "" + +#: ../../deprecated.rst:74 f5679d89326b456f92ebce9f8cc94eef +msgid ":index:`fullcopyPage` -- :meth:`Document.fullcopy_page`" +msgstr "" + +#: ../../deprecated.rst:75 e5c217293a39430f83bb41075f6ecf30 +msgid ":index:`gammaWith` -- :meth:`Pixmap.gamma_with`" +msgstr "" + +#: ../../deprecated.rst:76 3d7834c24d644c97a45ac11975266fcc +msgid ":index:`getArea` -- :meth:`Rect.get_area`" +msgstr "" + +#: ../../deprecated.rst:77 2017ced937b146fba82103ca4db34c86 +msgid ":index:`getArea` -- :meth:`IRect.get_area`" +msgstr "" + +#: ../../deprecated.rst:78 d64b881f279a432c939eea419b2585ae +msgid ":index:`getCharWidths` -- :meth:`Document.get_char_widths`" +msgstr "" + +#: ../../deprecated.rst:79 5bffcb5be273408cb2c93e05c1e2179b +msgid ":index:`getContents` -- :meth:`Page.get_contents`" +msgstr "" + +#: ../../deprecated.rst:80 58364386c9e8480b90238bfdda26496e +msgid ":index:`getDisplayList` -- :meth:`Page.get_displaylist`" +msgstr "" + +#: ../../deprecated.rst:81 47cef4456d5940cab8e499470c0d3b8a +msgid ":index:`getDrawings` -- :meth:`Page.get_drawings`" +msgstr "" + +#: ../../deprecated.rst:82 c6cf48b94ed9469f8ad8a301a25a2994 +msgid ":index:`getFontList` -- :meth:`Page.get_fonts`" +msgstr "" + +#: ../../deprecated.rst:83 4f9b377f1c3a40fe9d89111141a72711 +msgid ":index:`getImageBbox` -- :meth:`Page.get_image_bbox`" +msgstr "" + +#: ../../deprecated.rst:84 1b454a3494eb47ffbf24d5cb7917030a +msgid ":index:`getImageData` -- :meth:`Pixmap.tobytes`" +msgstr "" + +#: ../../deprecated.rst:85 95a23e040dd9483eaca2a6f928242233 +msgid ":index:`getImageList` -- :meth:`Page.get_images`" +msgstr "" + +#: ../../deprecated.rst:86 103ce65af6524ce9a41c57b30b12afdc +msgid ":index:`getLinks` -- :meth:`Page.get_links`" +msgstr "" + +#: ../../deprecated.rst:87 6331d8bce0114b3295fded5f4273755f +msgid ":index:`getOCGs` -- :meth:`Document.get_ocgs`" +msgstr "" + +#: ../../deprecated.rst:88 83052307864040f381ad2df3f6509aaa +msgid ":index:`getPageFontList` -- :meth:`Document.get_page_fonts`" +msgstr "" + +#: ../../deprecated.rst:89 cfd45a0c630e4665980395724e855477 +msgid ":index:`getPageImageList` -- :meth:`Document.get_page_images`" +msgstr "" + +#: ../../deprecated.rst:90 41df7b2e16c2466fa55ea9b153ee7085 +msgid ":index:`getPagePixmap` -- :meth:`Document.get_page_pixmap`" +msgstr "" + +#: ../../deprecated.rst:91 64c32d3256de455db80fb5b586143e4f +msgid ":index:`getPageText` -- :meth:`Document.get_page_text`" +msgstr "" + +#: ../../deprecated.rst:92 3b5055c425c74251842d4582e4d3a899 +msgid ":index:`getPageXObjectList` -- :meth:`Document.get_page_xobjects`" +msgstr "" + +#: ../../deprecated.rst:93 78fd7b80257b4d1188da094268cbfe66 +msgid ":index:`getPDFnow` -- :meth:`get_pdf_now`" +msgstr "" + +#: ../../deprecated.rst:94 2fb33cd712004fb1a06783b005d8d1c7 +msgid ":index:`getPDFstr` -- :meth:`get_pdf_str`" +msgstr "" + +#: ../../deprecated.rst:95 f3792538ee374f0781a900a8f90bc285 +msgid ":index:`getPixmap` -- :meth:`Page.get_pixmap`" +msgstr "" + +#: ../../deprecated.rst:96 8682932bcbfb409cbe0ab68a50c7cc81 +msgid ":index:`getPixmap` -- :meth:`Annot.get_pixmap`" +msgstr "" + +#: ../../deprecated.rst:97 fb7309b088294f19b9d974b0325f2a8b +msgid ":index:`getPixmap` -- :meth:`DisplayList.get_pixmap`" +msgstr "" + +#: ../../deprecated.rst:98 a46c828f393b455b87c81e75c3f19288 +msgid ":index:`getPNGData` -- :meth:`Pixmap.tobytes`" +msgstr "" + +#: ../../deprecated.rst:99 cf4090e144dd47009a0119cd5716903d +msgid ":index:`getPNGdata` -- :meth:`Pixmap.tobytes`" +msgstr "" + +#: ../../deprecated.rst:100 4a6b4ed82f5046f7a770f7d1a7815e76 +msgid ":index:`getRectArea` -- :meth:`Rect.get_area`" +msgstr "" + +#: ../../deprecated.rst:101 7699349c8b18467db7c31e4460eac3ee +msgid ":index:`getRectArea` -- :meth:`IRect.get_area`" +msgstr "" + +#: ../../deprecated.rst:102 42ad3f1f2c824d13aab21f3f394be003 +msgid ":index:`getSigFlags` -- :meth:`Document.get_sigflags`" +msgstr "" + +#: ../../deprecated.rst:103 bce71ee551c84c7e817e80e289939ab4 +msgid ":index:`getSVGimage` -- :meth:`Page.get_svg_image`" +msgstr "" + +#: ../../deprecated.rst:104 3d7219a31a63402b96642f583f1285bd +msgid ":index:`getText` -- :meth:`Page.get_text`" +msgstr "" + +#: ../../deprecated.rst:105 9baa9703bd144c56a08049a3764af5c7 +msgid ":index:`getText` -- :meth:`Annot.get_text`" +msgstr "" + +#: ../../deprecated.rst:106 2a556b0496594def9344ec77aec06c79 +msgid ":index:`getTextBlocks` -- :meth:`Page.get_text_blocks`" +msgstr "" + +#: ../../deprecated.rst:107 55ea7568c01c47189bc17fe6701ef3d0 +msgid ":index:`getTextbox` -- :meth:`Page.get_textbox`" +msgstr "" + +#: ../../deprecated.rst:108 fa2556cc9b7b406c864dfa4e520f8112 +msgid ":index:`getTextbox` -- :meth:`Annot.get_textbox`" +msgstr "" + +#: ../../deprecated.rst:109 44dc44fba8e64f8886efeaba967ddafe +msgid ":index:`getTextLength` -- :meth:`get_text_length`" +msgstr "" + +#: ../../deprecated.rst:110 b45f76be531f427095fff381fdf54dfb +msgid ":index:`getTextPage` -- :meth:`Page.get_textpage`" +msgstr "" + +#: ../../deprecated.rst:111 0fa32fc975f34d24a0847fcd8e33e924 +msgid ":index:`getTextPage` -- :meth:`Annot.get_textpage`" +msgstr "" + +#: ../../deprecated.rst:112 c366f3f6099b4e27a435842e25252dbb +msgid ":index:`getTextPage` -- :meth:`DisplayList.get_textpage`" +msgstr "" + +#: ../../deprecated.rst:113 8bd90f7989754b7e82bddfa3af536d82 +msgid ":index:`getTextWords` -- :meth:`Page.get_text_words`" +msgstr "" + +#: ../../deprecated.rst:114 9f3e9c87b9204e0098edafae5646f02b +msgid ":index:`getToC` -- :meth:`Document.get_toc`" +msgstr "" + +#: ../../deprecated.rst:115 e5c56b687bb14831ae4ac4294505c888 +msgid ":index:`getXmlMetadata` -- :meth:`Document.get_xml_metadata`" +msgstr "" + +#: ../../deprecated.rst:116 1ecb6a1f0cfb4a55a1add9491f6fbc96 +msgid ":index:`ImageProperties` -- :meth:`image_properties`" +msgstr "" + +#: ../../deprecated.rst:117 c8507fc0d7d94fbca4bb3758c7bca15d +msgid ":index:`includePoint` -- :meth:`Rect.include_point`" +msgstr "" + +#: ../../deprecated.rst:118 b95f3356a84a40a697b8d132c9237cb6 +msgid ":index:`includePoint` -- :meth:`IRect.include_point`" +msgstr "" + +#: ../../deprecated.rst:119 3b0b46f0d579411ea8938d6479b622c0 +msgid ":index:`includeRect` -- :meth:`Rect.include_rect`" +msgstr "" + +#: ../../deprecated.rst:120 e9ee06e2d54041e6822d3cdeafd53776 +msgid ":index:`includeRect` -- :meth:`IRect.include_rect`" +msgstr "" + +#: ../../deprecated.rst:121 d6b57bab856b4dcbac25d251e6c9114f +msgid ":index:`insertFont` -- :meth:`Page.insert_font`" +msgstr "" + +#: ../../deprecated.rst:122 e99f690b80ab494db4c26773f9df0b4d +msgid ":index:`insertImage` -- :meth:`Page.insert_image`" +msgstr "" + +#: ../../deprecated.rst:123 62f38118ad5c4451bea5f5abb0e7f42e +msgid ":index:`insertLink` -- :meth:`Page.insert_link`" +msgstr "" + +#: ../../deprecated.rst:124 bc00e3316a0e4d91af45375c6939e9d2 +msgid ":index:`insertPage` -- :meth:`Document.insert_page`" +msgstr "" + +#: ../../deprecated.rst:125 b07870c985514028acd1da8087893846 +msgid ":index:`insertPDF` -- :meth:`Document.insert_pdf`" +msgstr "" + +#: ../../deprecated.rst:126 a8f9a109329243ed922b57a5b24a388f +msgid ":index:`insertText` -- :meth:`Page.insert_text`" +msgstr "" + +#: ../../deprecated.rst:127 c21400c3c4b2478b9e257f56795b4384 +msgid ":index:`insertText` -- :meth:`Shape.insert_text`" +msgstr "" + +#: ../../deprecated.rst:128 1130a8e0aa6949be9284109343b746eb +msgid ":index:`insertTextbox` -- :meth:`Page.insert_textbox`" +msgstr "" + +#: ../../deprecated.rst:129 d94f686e932e4c2e8030f6ecfb9edb09 +msgid ":index:`insertTextbox` -- :meth:`Shape.insert_textbox`" +msgstr "" + +#: ../../deprecated.rst:130 7bad5ca5d3194205a902ef03f0c126de +msgid ":index:`invertIRect` -- :meth:`Pixmap.invert_irect`" +msgstr "" + +#: ../../deprecated.rst:131 cb09ecae991746a7a7a7ec89e713669d +msgid ":index:`isConvex` -- :attr:`Quad.is_convex`" +msgstr "" + +#: ../../deprecated.rst:132 d96649edb48644be977ba3c42ff5dd2d +msgid ":index:`isDirty` -- :attr:`Document.is_dirty`" +msgstr "" + +#: ../../deprecated.rst:133 a84182b658bc478c8b77e90f913a22f9 +msgid ":index:`isEmpty` -- :attr:`Rect.is_empty`" +msgstr "" + +#: ../../deprecated.rst:134 2edabb73449f45dd939730a2b1fad33d +msgid ":index:`isEmpty` -- :attr:`IRect.is_empty`" +msgstr "" + +#: ../../deprecated.rst:135 4fdfd11e142b4de3b3e0115b094a4a93 +msgid ":index:`isEmpty` -- :attr:`Quad.is_empty`" +msgstr "" + +#: ../../deprecated.rst:136 130648c59a8b45a192a03fa785be6b76 +msgid ":index:`isFormPDF` -- :attr:`Document.is_form_pdf`" +msgstr "" + +#: ../../deprecated.rst:137 fbcf75c913ce41b0b9aa5dc3e4117cb6 +msgid ":index:`isInfinite` -- :attr:`Rect.is_infinite`" +msgstr "" + +#: ../../deprecated.rst:138 0d82685835604a99bbc22fd9afb286fc +msgid ":index:`isInfinite` -- :attr:`IRect.is_infinite`" +msgstr "" + +#: ../../deprecated.rst:139 4e6f6a28e92f4c519ddd77e2678f4ba6 +msgid ":index:`isPDF` -- :attr:`Document.is_pdf`" +msgstr "" + +#: ../../deprecated.rst:140 f401f2e18fbf44a3a11df0b1858acd77 +msgid ":index:`isRectangular` -- :attr:`Quad.is_rectangular`" +msgstr "" + +#: ../../deprecated.rst:141 76f6c9900947413ba542732fd7a370df +msgid ":index:`isRectilinear` -- :attr:`Matrix.is_rectilinear`" +msgstr "" + +#: ../../deprecated.rst:142 3e6747568ea947e58b07740b88f80cf7 +msgid ":index:`isReflowable` -- :attr:`Document.is_reflowable`" +msgstr "" + +#: ../../deprecated.rst:143 59ec5050a1494de383fbabdeeb979b83 +msgid ":index:`isRepaired` -- :attr:`Document.is_repaired`" +msgstr "" + +#: ../../deprecated.rst:144 0f6b6a93bd9b42b9a05768b104880a47 +msgid ":index:`isStream` -- :meth:`Document.is_stream`" +msgstr "" + +#: ../../deprecated.rst:145 8d99e53713ea4c159ab6dc85b57d5458 +msgid ":index:`lastLocation` -- :attr:`Document.last_location`" +msgstr "" + +#: ../../deprecated.rst:146 1e4fc8654e7b4b07b9fc805e40a861b9 +msgid ":index:`lineEnds` -- :attr:`Annot.line_ends`" +msgstr "" + +#: ../../deprecated.rst:147 666478872a6f4fac84c758d3e48c5183 +msgid ":index:`loadAnnot` -- :meth:`Page.load_annot`" +msgstr "" + +#: ../../deprecated.rst:148 87fa2471ba774245ad942f11557ade8b +msgid ":index:`loadLinks` -- :meth:`Page.load_links`" +msgstr "" + +#: ../../deprecated.rst:149 3528afe3952c4972b64b9d7f76771d1e +msgid ":index:`loadPage` -- :meth:`Document.load_page`" +msgstr "" + +#: ../../deprecated.rst:150 191c78a78e2340b2b8cdbe6e0a74e738 +msgid ":index:`makeBookmark` -- :meth:`Document.make_bookmark`" +msgstr "" + +#: ../../deprecated.rst:151 b4bf38b4c5b445768d9288e3cc9351d5 +msgid ":index:`MediaBox` -- :attr:`Page.mediabox`" +msgstr "" + +#: ../../deprecated.rst:152 4c119b1e37a94778818289e875271e0f +msgid ":index:`MediaBoxSize` -- :attr:`Page.mediabox_size`" +msgstr "" + +#: ../../deprecated.rst:153 4d3ca7ecd54b4171b45912a3f9880c1a +msgid ":index:`metadataXML` -- :meth:`Document.xref_xml_metadata`" +msgstr "" + +#: ../../deprecated.rst:154 013377510a2b4b15923a092c6df114e8 +msgid ":index:`movePage` -- :meth:`Document.move_page`" +msgstr "" + +#: ../../deprecated.rst:155 2bde2f6782034cfc952e425746523db1 +msgid ":index:`needsPass` -- :attr:`Document.needs_pass`" +msgstr "" + +#: ../../deprecated.rst:156 4b0a4c646ff64571a8b788f38f8b140f +msgid ":index:`newPage` -- :meth:`Document.new_page`" +msgstr "" + +#: ../../deprecated.rst:157 234a10f09b4442e4b183b96af781c191 +msgid ":index:`newShape` -- :meth:`Page.new_shape`" +msgstr "" + +#: ../../deprecated.rst:158 5f82be9f19bf4e8ea4b29f567aa6bf5b +msgid ":index:`nextLocation` -- :meth:`Document.next_location`" +msgstr "" + +#: ../../deprecated.rst:159 dcf2aed7feec49c48574cb7d92a7ec94 +msgid ":index:`pageCount` -- :attr:`Document.page_count`" +msgstr "" + +#: ../../deprecated.rst:160 1ea5165ba6ee46ebb1100acf9ef3369e +msgid ":index:`pageCropBox` -- :meth:`Document.page_cropbox`" +msgstr "" + +#: ../../deprecated.rst:161 bb664db9cf7b485bb5dcdb72337e8c7f +msgid ":index:`pageXref` -- :meth:`Document.page_xref`" +msgstr "" + +#: ../../deprecated.rst:162 25ecff4635e440c8854ba142999a4545 +msgid ":index:`PaperRect` -- :meth:`paper_rect`" +msgstr "" + +#: ../../deprecated.rst:163 cc90cce7de8f4c6f897fca5c1ada4c72 +msgid ":index:`PaperSize` -- :meth:`paper_size`" +msgstr "" + +#: ../../deprecated.rst:164 69244ff19192402b96dc390d96301ee6 +msgid ":index:`paperSizes` -- :attr:`paper_sizes`" +msgstr "" + +#: ../../deprecated.rst:165 fb3aaa403afc4e61911a3f7bcc92e250 +msgid ":index:`PDFCatalog` -- :meth:`Document.pdf_catalog`" +msgstr "" + +#: ../../deprecated.rst:166 5142ca7a85954158b9534086412fb006 +msgid ":index:`PDFTrailer` -- :meth:`Document.pdf_trailer`" +msgstr "" + +#: ../../deprecated.rst:167 542548edf972427caeda277081b4bb77 +msgid ":index:`pillowData` -- :meth:`Pixmap.pil_tobytes`" +msgstr "" + +#: ../../deprecated.rst:168 6ef98872ca3e49eea54f1e6388bdf551 +msgid ":index:`pillowWrite` -- :meth:`Pixmap.pil_save`" +msgstr "" + +#: ../../deprecated.rst:169 abeb19db7fdc4bc485e0bd4bbcac0469 +msgid ":index:`planishLine` -- :meth:`planish_line`" +msgstr "" + +#: ../../deprecated.rst:170 bb266985faaf470fa6e3351cfface55f +msgid ":index:`preRotate` -- :meth:`Matrix.prerotate`" +msgstr "" + +#: ../../deprecated.rst:171 c03c058005e14019909cfb3432e979a3 +msgid ":index:`preScale` -- :meth:`Matrix.prescale`" +msgstr "" + +#: ../../deprecated.rst:172 967695b5256f4eb2b5ef734d3c1e71c2 +msgid ":index:`preShear` -- :meth:`Matrix.preshear`" +msgstr "" + +#: ../../deprecated.rst:173 8d7dcd3f5577443680378ae49921c23d +msgid ":index:`preTranslate` -- :meth:`Matrix.pretranslate`" +msgstr "" + +#: ../../deprecated.rst:174 72c367a6c466477aba809ebb978a47ce +msgid ":index:`previousLocation` -- :meth:`Document.prev_location`" +msgstr "" + +#: ../../deprecated.rst:175 4cb147a8013d402392a8e0c482b8cf97 +msgid ":index:`readContents` -- :meth:`Page.read_contents`" +msgstr "" + +#: ../../deprecated.rst:176 d8644ae3bf2c4fb8bcd22070d6ceb59a +msgid ":index:`resolveLink` -- :meth:`Document.resolve_link`" +msgstr "" + +#: ../../deprecated.rst:177 950504d325734cbd8515748e45e675e7 +msgid ":index:`rotationMatrix` -- :attr:`Page.rotation_matrix`" +msgstr "" + +#: ../../deprecated.rst:178 053654b5a09c4694b3e6e1085bb1c8f8 +msgid ":index:`searchFor` -- :meth:`Page.search_for`" +msgstr "" + +#: ../../deprecated.rst:179 b69eb7f3f6d64cc19da5bc997218d8da +msgid ":index:`searchPageFor` -- :meth:`Document.search_page_for`" +msgstr "" + +#: ../../deprecated.rst:180 8a633e7d41504f9dbba548d80570c7ad +msgid ":index:`setAlpha` -- :meth:`Pixmap.set_alpha`" +msgstr "" + +#: ../../deprecated.rst:181 339b3c9fea944d8f8d8388d01f5d9c22 +msgid ":index:`setBlendMode` -- :meth:`Annot.set_blendmode`" +msgstr "" + +#: ../../deprecated.rst:182 39e1b7aa70ab40469f1b2b53c8b3577e +msgid ":index:`setBorder` -- :meth:`Annot.set_border`" +msgstr "" + +#: ../../deprecated.rst:183 007c0ce78ae8431eb4a7ca889f74289c +msgid ":index:`setColors` -- :meth:`Annot.set_colors`" +msgstr "" + +#: ../../deprecated.rst:184 c168d5f300644feca6933124a2f61748 +msgid ":index:`setCropBox` -- :meth:`Page.set_cropbox`" +msgstr "" + +#: ../../deprecated.rst:185 58824a6077fd4737b68a3c920b172e56 +msgid ":index:`setFlags` -- :meth:`Annot.set_flags`" +msgstr "" + +#: ../../deprecated.rst:186 8203832216914f4a998bcac8fe47508e +msgid ":index:`setInfo` -- :meth:`Annot.set_info`" +msgstr "" + +#: ../../deprecated.rst:187 32713e82896d4a4dbf960065b54a992d +msgid ":index:`setLanguage` -- :meth:`Document.set_language`" +msgstr "" + +#: ../../deprecated.rst:188 d8919fbb8ad54e8c8ea9abe8ed330ad8 +msgid ":index:`setLineEnds` -- :meth:`Annot.set_line_ends`" +msgstr "" + +#: ../../deprecated.rst:189 80f9ee21d5124c769d5a66a6cf9ab656 +msgid ":index:`setMediaBox` -- :meth:`Page.set_mediabox`" +msgstr "" + +#: ../../deprecated.rst:190 fdce6b9c22e842c6a254651b49101862 +msgid ":index:`setMetadata` -- :meth:`Document.set_metadata`" +msgstr "" + +#: ../../deprecated.rst:191 fa67b1f2e736486cbd5f3470c169987f +msgid ":index:`setName` -- :meth:`Annot.set_name`" +msgstr "" + +#: ../../deprecated.rst:192 a3c26becbef44f2fafafa75d153a2b6e +msgid ":index:`setOC` -- :meth:`Annot.set_oc`" +msgstr "" + +#: ../../deprecated.rst:193 beae43434ab84349a07bf9e4b145dcb4 +msgid ":index:`setOpacity` -- :meth:`Annot.set_opacity`" +msgstr "" + +#: ../../deprecated.rst:194 931b78cba7024de6b2c9c7dea7ab5604 +msgid ":index:`setOrigin` -- :meth:`Pixmap.set_origin`" +msgstr "" + +#: ../../deprecated.rst:195 9e9747e3c8aa47cbad7f68cd2d396b6f +msgid ":index:`setPixel` -- :meth:`Pixmap.set_pixel`" +msgstr "" + +#: ../../deprecated.rst:196 5df77f81227647c2b5911929b0271a72 +msgid ":index:`setRect` -- :meth:`Annot.set_rect`" +msgstr "" + +#: ../../deprecated.rst:197 b1b3b35edf2a4909807a458213f529bc +msgid ":index:`setRect` -- :meth:`Pixmap.set_rect`" +msgstr "" + +#: ../../deprecated.rst:198 428f60ffa6864527a587de1448783875 +msgid ":index:`setResolution` -- :meth:`Pixmap.set_dpi`" +msgstr "" + +#: ../../deprecated.rst:199 7c12e93550474f6f9da1ec5448d8c037 +msgid ":index:`setRotation` -- :meth:`Page.set_rotation`" +msgstr "" + +#: ../../deprecated.rst:200 0ae73b140bc3429aa893fe080a3eb560 +msgid ":index:`setToC` -- :meth:`Document.set_toc`" +msgstr "" + +#: ../../deprecated.rst:201 9da5c9761f7c415b9efe99812e95a40e +msgid ":index:`setXmlMetadata` -- :meth:`Document.set_xml_metadata`" +msgstr "" + +#: ../../deprecated.rst:202 1ab6df0b3cae4f4d95a95d58cd0268e6 +msgid ":index:`showPDFpage` -- :meth:`Page.show_pdf_page`" +msgstr "" + +#: ../../deprecated.rst:203 53d1a90bb6af4380bc29a6524eec82a7 +msgid ":index:`soundGet` -- :meth:`Annot.get_sound`" +msgstr "" + +#: ../../deprecated.rst:204 6f066b4d12f54057a6041f2744098c84 +msgid ":index:`tintWith` -- :meth:`Pixmap.tint_with`" +msgstr "" + +#: ../../deprecated.rst:205 7e03bc0aebc34f6286cf47e405f13fc1 +msgid ":index:`transformationMatrix` -- :attr:`Page.transformation_matrix`" +msgstr "" + +#: ../../deprecated.rst:206 8db984d64fca43e9b9b0a64e5e5fd840 +msgid ":index:`updateLink` -- :meth:`Page.update_link`" +msgstr "" + +#: ../../deprecated.rst:207 ea3c1d96c54540d19e5499c707af5a64 +msgid ":index:`updateObject` -- :meth:`Document.update_object`" +msgstr "" + +#: ../../deprecated.rst:208 8cc08bccc1284d4086497431b10e9e63 +msgid ":index:`updateStream` -- :meth:`Document.update_stream`" +msgstr "" + +#: ../../deprecated.rst:209 43d07e0905eb4bdc91d9b9dfd5088e51 +msgid ":index:`wrapContents` -- :meth:`Page.wrap_contents`" +msgstr "" + +#: ../../deprecated.rst:210 1adcea546c35408da5a7dce8dee49e1c +msgid ":index:`writeImage` -- :meth:`Pixmap.save`" +msgstr "" + +#: ../../deprecated.rst:211 8d6d15eb003d40aea8a5dd6a76179d92 +msgid ":index:`writePNG` -- :meth:`Pixmap.save`" +msgstr "" + +#: ../../deprecated.rst:212 66d656e80dcf4f35b6b5e89abd0a46b1 +msgid ":index:`writeText` -- :meth:`Page.write_text`" +msgstr "" + +#: ../../deprecated.rst:213 e03cf47ad99f49ae9b83837db47bbce1 +msgid ":index:`writeText` -- :meth:`TextWriter.write_text`" +msgstr "" + +#: ../../deprecated.rst:214 f66e33aa56c54ed3bb974c8af21cad14 +msgid ":index:`xrefLength` -- :meth:`Document.xref_length`" +msgstr "" + +#: ../../deprecated.rst:215 aec8c8474062494287ee9a4d59c8f9bf +msgid ":index:`xrefObject` -- :meth:`Document.xref_object`" +msgstr "" + +#: ../../deprecated.rst:216 8be5c53cf5744479ab6e68171f3ac389 +msgid ":index:`xrefStream` -- :meth:`Document.xref_stream`" +msgstr "" + +#: ../../deprecated.rst:217 65d9c158dbb94e8e86b6eaea258767f7 +msgid ":index:`xrefStreamRaw` -- :meth:`Document.xref_stream_raw`" +msgstr "" + +#: ../../footer.rst:-1 b4d0f4633117446c83e32734fd294137 +msgid "Discord logo" +msgstr "" + diff --git a/docs/the-basics.rst b/docs/the-basics.rst index 6102debbb..66dc35f37 100644 --- a/docs/the-basics.rst +++ b/docs/the-basics.rst @@ -114,14 +114,16 @@ Supported File Types + + - + - + - +
File type
Document Formats
 PDF XPS @@ -134,16 +136,47 @@ Supported File Types
Image Formats
 -
Input formats JPG/JPEG, PNG, BMP, GIF, TIFF, PNM, PGM, PBM, PPM, PAM, JXR, JPX/JP2, PSD
-
Output formats JPG/JPEG, PNG, PNM, PGM, PBM, PPM, PAM, PSD, PS
+
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
+ + .. _The_Basics_Opening_Files: