PyMuPDF 1.23.0rc1 - en to ja translation catalogue (206 entries)

en: PyMuPDF is a high-performance Python library for data extraction, analysis, conversion & manipulation of PDF (and other) documents.
ja: PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。

en: PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, PDF Splitting, PDF Creation, Pyodide, PyScript
ja: PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript

en: Annot
ja: Annot (注釈)

en: **This class is supported for PDF documents only.**
ja: **このクラスはPDFドキュメントのみに対応しています。**

en: 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."
ja: :ref:`AdobeManual` からの引用: 「注釈は、ノート、音声、動画などのオブジェクトをPDFドキュメントのページ上の位置に関連付けるか、マウスとキーボードを介してユーザーと対話する手段を提供します。」

en: 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.
ja: 注釈とそのページとの間には親子関係があります。ページオブジェクトが使用できなくなる場合（閉じたドキュメント、文書構造の変更など）、そのページに存在するすべての注釈オブジェクトも同様に使用できなくなります。注釈のプロパティやメソッドにアクセスされるたびに、オブジェクトが「孤立した」という例外が発生します。

en: **Attribute**
ja: **アトリビュート**

en: **Short Description**
ja: **短い説明**

en: delete all responding annotions
ja: すべての応答アノテーションを削除します

en: get attached file content
ja: 添付ファイルの内容を取得します

en: get :data:`xref` of an :data:`OCG` / :data:`OCMD`
ja: :data:`xref` を :data:`OCG` または :data:`OCMD` に取得します。

en: image of the annotation as a pixmap
ja: アノテーションの画像をピクマップとして取得します

en: get the sound of an audio annotation
ja: オーディオアノテーションの音声を取得します

en: extract annotation text
ja: アノテーションテキストを抽出します

en: set annotation's border properties
ja: アノテーションの境界線のプロパティを設定します

en: set annotation's blend mode
ja: アノテーションのブレンドモードを設定します

en: set annotation's colors
ja: アノテーションの色を設定します

en: set annotation's flags field
ja: アノテーションのフラグフィールドを設定します

en: define the annotation to being "In Response To"
ja: アノテーションを「応答対象」として定義します

en: set annotation's name field
ja: アノテーションの名前フィールドを設定します

en: set :data:`xref` to an :data:`OCG` / :data:`OCMD`
ja: :data:`xref` を :data:`OCG` または :data:`OCMD` に設定します。

en: change transparency
ja: 透明度を変更します

en: open / close annotation or its Popup
ja: アノテーションまたはそのポップアップを開く/閉じる

en: create a Popup for the annotation
ja: アノテーションのためのポップアップを作成します

en: change annotation rectangle
ja: アノテーションの長方形を変更します

en: change rotation
ja: 回転を変更します

en: update attached file content
ja: 添付ファイルの内容を更新します

en: apply accumulated annot changes
ja: 蓄積されたアノテーションの変更を適用します

en: annotation BlendMode
ja: アノテーションのブレンドモード

en: border details
ja: 境界線の詳細

en: border / background and fill colors
ja: 境界線/背景および塗りつぶしの色

en: get attached file information
ja: 添付ファイル情報を取得します

en: annotation flags
ja: アノテーションフラグ

en: whether annotation has a Popup
ja: アノテーションにポップアップがあるかどうか

en: annotation to which this one responds
ja: このアノテーションへの応答としてのアノテーション

en: various information
ja: さまざまな情報

en: whether annotation or its Popup is open
ja: アノテーションまたはそのポップアップが開いているかどうか

en: start / end appearance of line-type annotations
ja: 線タイプのアノテーションの始点/終点の外観

en: link to the next annotation
ja: 次のアノテーションへのリンク

en: the annot's transparency
ja: アノテーションの透明度

en: page object of the annotation
ja: アノテーションのページオブジェクト

en: rectangle of the annotation's Popup
ja: アノテーションのポップアップの長方形

en: the PDF :data:`xref` number of the annotation's Popup
ja: アノテーションのポップアップのPDF :data:`xref` 番号

en: rectangle containing the annotation
ja: アノテーションを含む長方形

en: type of the annotation
ja: アノテーションのタイプ

en: point coordinates of Polygons, PolyLines, etc.
ja: ポリゴン、ポリラインなどの点の座標

en: the PDF :data:`xref` number
ja: PDF :data:`xref` 番号

en: **Class API**
ja:  **APIクラス**

en: Changed in v1.19.2: added support of dpi parameter.
ja: v1.19.2で変更: dpiパラメータのサポートが追加されました。

en: 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.**
ja: 変換されていない座標でページ上に表示される注釈からピクスマップを作成します。ピクスマップの :ref:`IRect` は *Annot.rect.irect* と同じです（以下を参照）。 **すべてのパラメータはキーワード専用です。**

en: Parameters
ja: パラメータ

en: a matrix to be used for image creation. Default is :ref:`Identity`.
ja: 画像の作成に使用される行列。デフォルトは :ref:`Identity` です。

en: (new in v1.19.2) desired resolution in dots per inch. If not `None`, the matrix parameter is ignored.
ja: （v1.19.2で新規追加）インチあたりのドット数で指定された解像度。 `None` でない場合、matrixパラメータは無視されます。

en: a colorspace to be used for image creation. Default is *fitz.csRGB*.
ja: 画像の作成に使用されるカラースペース。デフォルトは *fitz.csRGB* です。

en: whether to include transparency information. Default is *False*.
ja: 透明情報を含めるかどうか。デフォルトは *False* です。

en: Return type
ja: 戻り値の型

en: New in 1.18.0
ja: 1.18.0 で新たに追加

en: 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).
ja: さまざまなフォーマットで注釈の内容を取得します - これは :ref:`Page` の同じメソッドのように動作します。現在、これはアノテーションタイプ「FreeText」と「Stamp」に関連するデータのみを提供します。他の種類は空の文字列（または同等のオブジェクト）を返します。

en: (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`.
ja: (位置指定のみ) 望ましいフォーマット - 以下のいずれかの値の1つです。このメソッドは、:ref:`Page` の同名のメソッドとまったく同じように動作することに注意してください。

en: "text" -- :meth:`TextPage.extractTEXT`, default
ja: "text" -- :meth:`TextPage.extractTEXT`、デフォルト

en: (keyword only) restrict the extraction to this area. Should hardly ever be required, defaults to :attr:`Annot.rect`.
ja: (キーワードのみ) このエリアに抽出を制限します。ほとんど必要ない場合がほとんどで、デフォルトは :attr:`Annot.rect` です。

en: (keyword only) control the amount of data returned. Defaults to simple text extraction.
ja: (キーワードのみ) 返されるデータの量を制御します。単純なテキスト抽出がデフォルトです。

en: Return the annotation text. Mostly (except line breaks) equal to :meth:`Annot.get_text` with the "text" option.
ja: 注釈のテキストを返します。主に（改行を除く）「text」オプションを使用した :meth:`Annot.get_text` と同等です

en: the area to consider, defaults to :attr:`Annot.rect`.
ja: rect (rect-like) – 考慮する領域、デフォルトは :attr:`Annot.rect` です。

en: Changed in version 1.16.10
ja: バージョン 1.16.10 で変更

en: 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.
ja: 注釈のプロパティを変更します。これには日付、内容、題名、および著者（タイトル）が含まれます。*名前* と *ID* の変更は無視されます。更新は選択的に行われます：プロパティを変更しない場合は、それを *None* に設定します。既存のデータを削除するには、空の文字列を使用します。

en: 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.
ja: *info* プロパティと互換性のある辞書（以下参照）。すべてのエントリは文字列である必要があります。この引数が辞書でない場合、他の引数が代わりに使用されます。それ以外の場合、無視されます。

en: *(new in v1.16.10)* see description in :attr:`info`.
ja: *（v1.16.10 で新規追加）* :attr:`info` の説明を参照してください。

en: *(new in v1.16.10)* date of annot creation. If given, should be in PDF datetime format.
ja: *（v1.16.10 で新規追加）* 注釈の作成日。指定する場合、PDF 日時形式である必要があります。

en: *(new in v1.16.10)* date of last modification. If given, should be in PDF datetime format.
ja: *（v1.16.10 で新規追加）* 最終変更日。指定する場合、PDF 日時形式である必要があります。

en: 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.
ja: 注釈の線終端スタイルを設定します。これらの注釈タイプの各々は、線で接続された点のリストによって定義されています。*start* で指定されたシンボルは、最初の点に、*end* はこのリストの最後の点に取り付けられます。サポートされていない注釈タイプの場合、警告メッセージとともに無操作となります。

en: 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.
ja: 「FreeText」、「Line」、「PolyLine」、および「Polygon」注釈はこれらのプロパティを持つことができますが、（Py-）MuPDF は「FreeText」の線終端をサポートしていません。なぜなら、そのコールアウトバリアントはサポートされていないからです。

en: *(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.
ja: *（v1.16.16 で変更）* 一部のシンボルには内部領域（ダイヤモンド、円、正方形など）があります。デフォルトでは、これらの領域は注釈の塗りつぶし色で塗りつぶされます。これが *None* の場合、白色が選択されます。:meth:`Annot.update` の *fill_color* 引数を使用して、線終端シンボルに独自の塗りつぶし色を設定することができるようになりました。

en: The symbol number for the first point.
ja: 最初の点のシンボル番号。

en: The symbol number for the last point.
ja: 最後の点のシンボル番号。

en: 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`.
ja: PDFのオプションコンテンツメカニズムを使用して、注釈の表示/非表示を設定します。この表示は、サポートするPDFビューアのユーザーインターフェースによって制御されます。:attr:`Annot.flags` のような他の属性とは独立しています。

en: 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.
ja: オプションコンテンツグループ（OCGまたはOCMD）のxref。以前の :data:`xref` は上書きされます。ゼロの場合、以前のエントリが削除されます。xrefがゼロでない場合かつ有効なPDFオブジェクトを指していない場合、例外が発生します。

en: This does **not require executing** :meth:`Annot.update` to take effect.
ja: これは :meth:`Annot.update` の **実行を必要としません。**

en: Return the :data:`xref` of an optional content object, or zero if there is none.
ja: オプションコンテンツオブジェクトの :data:`xref` 、または存在しない場合はゼロを返します。

en: Returns
ja: 戻り値

en: zero or the xref of an OCG (or OCMD).
ja: ゼロまたはOCG（またはOCMD）のxref。

en: New in v1.19.3
ja: v1.19.3 で新規追加

en: Set annotation to be "In Response To" another one.
ja: 注釈を別の注釈への「応答として」設定します。

en: The :data:`xref` of another annotation.
ja: 別の注釈の :data:`xref` 。

en: Must refer to an existing annotation on this page. Setting this property requires no subsequent `update()`.
ja: このプロパティを設定するには、このページの既存の注釈を参照する必要があります。このプロパティを設定する際、後続の `update()` は不要です。

en: New in v1.18.4
ja: v1.18.4 で新たに追加

en: Set the annotation's Popup annotation to open or closed -- **or** the annotation itself, if its type is 'Text' ("sticky note").
ja: 注釈のポップアップ注釈を開いた状態または閉じた状態に設定します – *または* その注釈自体、そのタイプが 'Text'（「付箋」）の場合。

en: the desired open state.
ja: 望ましい開いた状態。

en: Create a Popup annotation for the annotation and specify its rectangle. If the Popup already exists, only its rectangle is updated.
ja: 注釈のためのポップアップ注釈を作成し、その矩形を指定します。ポップアップが既に存在する場合、その矩形のみが更新されます。

en: the desired rectangle.
ja: 望ましい矩形。

en: Set the annotation's transparency. Opacity can also be set in :meth:`Annot.update`.
ja: 注釈の透明度を設定します。透明度は :meth:`Annot.update` でも設定できます。

en: 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%.
ja: *[0、1]* の範囲内の浮動小数点数。範囲外の値は 1 と見なされます。例：0.5 の値は透明度を 50% に設定します。

en: Three overlapping 'Circle' annotations with each opacity set to 0.5:
ja: 透明度がそれぞれ 0.5 に設定された3つの重なる「Circle」注釈：

en: The annotation's blend mode. See :ref:`AdobeManual`, page 324 for explanations.
ja: 注釈のブレンドモード。詳細については :ref:`AdobeManual` 、ページ324を参照してください。

en: the blend mode or *None*.
ja: ブレンドモードまたは *None* 。

en: New in v1.16.14
ja: v1.16.14 で新たに追加

en: Set the annotation's blend mode. See :ref:`AdobeManual`, page 324 for explanations. The blend mode can also be set in :meth:`Annot.update`.
ja: 注釈のブレンドモードを設定します。詳細については :ref:`AdobeManual` 、ページ324を参照してください。ブレンドモードは :meth:`Annot.update` でも設定できます。

en: 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.
ja: ブレンドモードを設定します。視覚的な外観に反映するには :meth:`Annot.update` を使用します。事前定義の値についてはPDF標準のブレンドモードを参照してください。ブレンドモードを **削除する** には `PDF_BM_Normal` を使用します。

en: New in version 1.16.0
ja: バージョン1.16.0で新たに追加

en: 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`.
ja: すべての注釈タイプの名前フィールドを変更します。「FileAttachment」と「Text」注釈の場合、これはアイコンの名前であり、「Stamp」注釈の場合はスタンプのテキストです。視覚的な結果（ある場合）は、PDFビューアに依存します。:ref:`mupdficons` も参照してください。

en: the new name.
ja: 新しい名前。

en: If you set the name of a 'Stamp' annotation, then this will **not change** the rectangle, nor will the text be layouted in any way. If you choose a standard text from :ref:`StampIcons` (the **exact** name piece after `"STAMP_"`), you should receive the original layout. An **arbitrary text** will not be changed to upper case, but be written in font "Times-Bold" as is, horizontally centered in **one line** and be shortened to fit. To get your text fully displayed, its length using :data:`fontsize` 20 must not exceed 190 points. So please make sure that the following inequality is true: `fitz.get_text_length(text, fontname="tibo", fontsize=20) <= 190`.
ja: 「Stamp」注釈の名前を設定した場合、これは矩形を **変更せず** 、テキストもレイアウトされません。:ref:`StampIcons` から標準のテキストを選択すると（ `"STAMP_"` の後の **正確な** 名前部分）、元のレイアウトが表示されるはずです。**任意** のテキストは大文字に変更されず、「Times-Bold」フォントで水平中央揃えで **1行** に表示され、収まるように短縮されます。テキストを完全に表示するには、フォントサイズ20を使用してのテキストの長さが190ピクセルを超えてはいけません。したがって、以下の不等式が成り立つことを確認してください: `fitz.get_text_length(text, fontname="tibo", fontsize=20) <= 190` 。

en: 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.
ja: 注釈の矩形を変更します。注釈は移動し、矩形の両側を独立してスケーリングできます。ただし、注釈の外観は回転、反転、またはせん断されることはありません。このメソッドは特定の注釈タイプにのみ影響を与えます [#f2]_  、それ以外の場合はPythonの `sys.stderr` にメッセージが表示されます。例外は発生しませんが、`False` が返されます。

en: 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.
ja: rect (rect_like) – 注釈の新しい矩形（有限で空ではない）です。たとえば、*annot.rect + (5, 5, 5, 5)* の値を使用すると、注釈を右に5ピクセル、下に5ピクセル移動させます。

en: You **need not** invoke :meth:`Annot.update` for activation of the effect.
ja: 効果の有効化には :meth:`Annot.update` を呼び出す **必要はありません** 。

en: 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.
ja: 注釈の回転を設定します。これにより、注釈の矩形はその中心点を中心に回転します。その後、結果の四角形から **新しい注釈の矩形** が計算されます。

en: rotation angle in degrees. Arbitrary values are possible, but will be clamped to the interval `[0, 360)`.
ja: 度数法での回転角度。任意の値が可能ですが、区間 `[0, 360)` にクランプされます。

en: You **must invoke** :meth:`Annot.update` to activate the effect.
ja: 効果を有効にするには、:meth:`Annot.update` を **呼び出す必要があります** 。

en: 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.
ja: PDF_ANNOT_FREE_TEXTの場合、値0、90、180、270のいずれかの値のみが可能で、現在の矩形内の **テキストを回転させます** （矩形自体は変更されません）。その他の値は静かに無視され、0に置き換えられます。

en: 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.
ja: それ以外の場合、次の :ref:`AnnotationTypes` のみが回転できます：'Square'、'Circle'、'Caret'、'Text'、'FileAttachment'、'Ink'、'Line'、'Polyline'、'Polygon'、および'Stamp'。それ以外のすべての場合、このメソッドは無効です。

en: Changed in version 1.16.9: Allow specification without using a dictionary. The direct parameters are used if *border* is not a dictionary.
ja: バージョン1.16.9で変更: 辞書を使用せずに指定を許可。*border* が辞書でない場合、直接のパラメータが使用されます。

en: Changed in version 1.22.5: Support of the "cloudy" border effect.
ja: バージョン1.22.5で変更: "cloudy"ボーダーエフェクトのサポート。

en: PDF only: Change border width, dashing, style and cloud effect. See the :attr:`Annot.border` attribute for more details.
ja: PDFのみ: ボーダーの幅、点線、スタイル、およびクラウド効果を変更します。詳細については :attr:`Annot.border` 属性を参照してください。

en: 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.
ja: :attr:`border` プロパティから返されるような辞書で、キーに "width"（float）、"style"（str）、"dashes"（シーケンス）、および "clouds"（int）を持っています。省略されたキーはそれぞれのプロパティを変更しないままにします。他の引数を使用する場合、border引数を `None` （デフォルト）に設定します。

en: A non-negative value will change the border line width.
ja: 非負の値はボーダーの線幅を変更します。

en: A value other than `None` will change this border property.
ja: `None` 以外の値はこのボーダープロパティを変更します。

en: 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).
ja: シーケンスのすべてのアイテムは整数である必要があり、それ以外の場合、パラメータは無視されます。点線を削除するには、`dashes=[]` を使用します。dashesが空でないシーケンスの場合、"style"は自動的に "D"（点線）に設定されます。

en: 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.
ja: 0以上の値はこのプロパティを変更します。クラウディな外観を完全に削除するには、`clouds=0` を使用します。このプロパティはアノテーションタイプ 'Square'、'Circle'、および 'Polygon' のみでサポートされています。

en: Changes the annotation flags. Use the `|` operator to combine several.
ja: 注釈のフラグを変更します。複数のフラグを組み合わせるには `|` 演算子を使用します。

en: an integer specifying the required flags.
ja: 必要なフラグを指定する整数。

en: Changed in version 1.16.9: Allow colors to be directly set. These parameters are used if *colors* is not a dictionary.
ja: バージョン1.16.9で変更: 色を直接設定できるようにしました。これらのパラメータは、*colors* が辞書でない場合に使用されます。

en: Changes the "stroke" and "fill" colors for supported annotation types -- not all annotations accept both.
ja: サポートされている注釈タイプに対して「ストローク」と「塗りつぶし」の色を変更します – すべての注釈が両方を受け入れるわけではありません。

en: 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.
ja: 色の仕様を含む辞書。受け入れられる辞書のキーと値については以下を参照してください。最も実用的な方法は、まず ** プロパティのコピーを作成し、その後必要に応じてこの辞書を変更することです。

en: see above.
ja: 上記を参照してください。

en: *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.
ja: *バージョン1.18.5で変更:*  色の仕様を完全に削除するには、`[]` のような空のシーケンスを使用してください。`None` を指定した場合、既存の仕様は変更されません。

en: New in version 1.16.12
ja: バージョン1.16.12で新規追加

en: Delete annotations referring to this one. This includes any 'Popup' annotations and all annotations responding to it.
ja: この注釈を参照する注釈を削除します。これには「ポップアップ」注釈とそれに応答するすべての注釈が含まれます。

en: Synchronize the appearance of an annotation with its properties after relevant changes.
ja: 関連する変更後に注釈の外観をプロパティに同期させます。

en: You can safely **omit** this method **only** for the following changes:
ja: 以下の変更に関して **のみ** 、このメソッドを安全に **省略できます** :

en: :meth:`Annot.set_info` (except any changes to *"content"*)
ja: :meth:`Annot.set_info` （*「content」* 以外の変更を除く）

en: 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.
ja: すべての引数はオプションです。 *(v1.16.14で変更)* ブレンドモードと不透明度は **すべての注釈タイプ** に適用されます。 他の引数は主に特殊な用途として、以下で説明されています。

en: 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.
ja: カラーの仕様は、通常のPuMuPDFで使用される形式で指定できます。0.0から1.0までの浮動小数点数のシーケンスです（両方を含む）。シーケンスの長さは1、3、または4である必要があります（GRAY、RGB、およびCMYKのカラースペースをサポートしています）。GRAYの場合、浮動小数点数だけでも受け入れられます。

en: *(new in v1.16.14)* **valid for all annotation types:** change or set the annotation's transparency. Valid values are *0 <= opacity < 1*.
ja: *（v1.16.14で新規）* **すべての注釈タイプに対して有効：** 注釈の透明度を変更または設定します。有効な値は *0 <= opacity < 1です* 。

en: *(new in v1.16.14)* **valid for all annotation types:** change or set the annotation's blend mode. For valid values see :ref:`BlendModes`.
ja: *（v1.16.14で新規）* **すべての注釈タイプに対して有効：** 注釈のブレンドモードを変更または設定します。有効な値についてはPDF標準のブレンドモードを参照してください。

en: change the text color. 'FreeText' annotations only.
ja: テキストの色を変更します。 'FreeText' 注釈のみです。

en: change the border color. 'FreeText' annotations only.
ja: 境界線の色を変更します。 'FreeText' 注釈のみです。

en: the fill color.
ja: 塗りつぶしの色です。

en: '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)*.
ja: 'Line'、'Polyline'、'Polygon' 注釈：適用可能な線の端のシンボルに注釈の色以外の塗りつぶしの色を与えるために使用します *（v1.16.16で変更）* 。

en: *(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*.
ja: *（v1.17.2で新規）* 注釈の矩形に2本の対角線を追加します。 'Redact' 注釈のみです。希望しない場合、注釈が*False* で作成された場合でも *False* を指定する必要があります。

en: 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.
ja: 新しい回転値。デフォルト値（-1）は変更なしを意味します。 'FreeText' およびいくつかの他の注釈タイプをサポートします:meth:`Annot.set_rotation` を参照） [#f1]_ 。 'FreeText' の場合、0、90、180、または270度を選択してください。それ以外の場合、任意の整数が受け入れられます。

en: 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.
ja: :meth:`Page.annots` ループ内でこのメソッドを使用することは **お勧めしません！** これは、ほとんどの注釈の更新には所有ページの再読み込みが必要であり、このループ内で行うことはできないためです。このジェネレータのドキュメントで提供されている例のコーディングパターンを使用してください。

en: Basic information of the annot's attached file.
ja: アノットが添付されたファイルの基本情報。

en: a dictionary with keys *filename*, *ufilename*, *desc* (description), *size* (uncompressed file size), *length* (compressed length) for FileAttachment annot types, else *None*.
ja: FileAttachmentアノットタイプの場合、*filename* （ファイル名）、*ufilename* （Unicodeファイル名）、*desc* （説明）、*size* （非圧縮ファイルサイズ）、*length* （圧縮長さ）のキーを持つ辞書。それ以外の場合は *None* 。

en: Returns attached file content.
ja: 添付ファイルの内容を返します。

en: the content of the attached file.
ja: 添付ファイルの内容。

en: Updates the content of an attached file. All arguments are optional. No arguments lead to a no-op.
ja: 添付ファイルの内容を更新します。すべての引数はオプションです。引数が指定されない場合、操作は行われません。

en: the new file content. Omit to only change meta-information.
ja: 新しいファイルの内容。メタ情報のみ変更する場合は省略します。

en: *(Changed in version 1.14.13)* *io.BytesIO* is now also supported.
ja: *（バージョン1.14.13で変更）io.BytesIO* もサポートされるようになりました。

en: new filename to associate with the file.
ja: ファイルに関連付ける新しいファイル名。

en: new unicode filename to associate with the file.
ja: ファイルに関連付ける新しいUnicodeファイル名。

en: new description of the file content.
ja: ファイル内容の新しい説明。

en: Return the embedded sound of an audio annotation.
ja: オーディオアノテーションの埋め込まれた音声を返します。

en: the sound audio file and accompanying properties. These are the possible dictionary keys, of which only "rate" and "stream" are always present.
ja: 音声オーディオファイルと関連するプロパティ。これらは可能な辞書キーで、常に「rate」と「stream」が存在します。

en: Key
ja: キー

en: Description
ja: 説明

en: (float, requ.) samples per second
ja: (float, 必須) 1秒あたりのサンプル数

en: (int, opt.) number of sound channels
ja: (int, オプション) サウンドチャンネルの数

en: (int, opt.) bits per sample value per channel
ja: (int, オプション) チャンネルごとのサンプル値のビット数

en: (str, opt.) encoding format: Raw, Signed, muLaw, ALaw
ja: (str, オプション) エンコーディング形式: Raw, Signed, muLaw, ALaw

en: (str, opt.) name of compression filter
ja: (str, オプション) 圧縮フィルタの名前

en: (bytes, requ.) the sound file content
ja: (bytes, 必須) サウンドファイルの内容

en: 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.
ja: アノテーションの透明度。設定されている場合、範囲 *[0, 1]* の値です。PDFのデフォルトは1ですが、違いを示すために設定されていない場合は *-1.0* を返します。

en: The owning page object of the annotation.
ja: アノテーションの所属ページオブジェクト。

en: The annot rotation.
ja: アノテーションの回転角度。

en: 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.
ja: 値は[-1, 359]です。回転が全くない場合、-1が返されます（回転角度0を意味します）。その他の可能な値は、一定の値0 <= angle < 360に正規化されます。

en: The rectangle containing the annotation.
ja: アノテーションを含む長方形領域。

en: The next annotation on this page or None.
ja: このページ上の次のアノテーションまたはNone。

en: 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.
ja: アノテーションタイプ を説明する数値と1つまたは2つの文字列、例: **[2, 'FreeText', 'FreeTextCallout']** 。第2の文字列エントリはオプションで、空であるかもしれません。可能な値とその意味については、付録の :ref:`AnnotationTypes` のリストを参照してください。

en: A dictionary containing various information. All fields are optional strings. For information items not provided, an empty string is returned.
ja: 異なる情報を含む辞書。すべてのフィールドはオプションの文字列です。提供されない情報項目については、空の文字列が返されます。

en: *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).
ja: *name* – たとえば、 'Stamp' 注釈の場合、 'Sold' または 'Experimental' のようなスタンプテキストが含まれ、他の注釈のタイプでは注釈のアイコンの名前がここに表示されます（FileAttachment の場合は 'PushPin'）。

en: *content* -- a string containing the text for type *Text* and *FreeText* annotations. Commonly used for filling the text field of annotation pop-up windows.
ja: *content*  – *テキスト* タイプと *FreeText* 注釈のテキストを含む文字列。注釈のポップアップウィンドウのテキストフィールドを埋めるために一般的に使用されます。

en: *title* -- a string containing the title of the annotation pop-up window. By convention, this is used for the **annotation author**.
ja: *title* – 注釈のポップアップウィンドウのタイトルを含む文字列。通常、これは **注釈の著者** に使用されます。

en: *creationDate* -- creation timestamp.
ja: *creationDate* – 作成タイムスタンプ。

en: *modDate* -- last modified timestamp.
ja: *modDate* – 最終変更タイムスタンプ。

en: *subject* -- subject.
ja: *subject* – 主題。

en: *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.
ja: *id* – （バージョン1.16.10で新規追加）注釈の一意の識別子。これはPDFキー */ NM* から取得されます。PyMuPDFによって追加された注釈には一意の名前があり、ここに表示されます

en: An integer whose low order bits contain flags for how the annotation should be presented.
ja: 注釈の表示方法を示すフラグを含む低位ビットを持つ整数。

en: 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.
ja: 'FreeText'、'Line'、'PolyLine'、および'Polygon'の注釈タイプの開始および終了シンボルを指定する2つの整数のペア。該当しない場合は *なし* 。このリストでの可能な値と説明については、:ref:`AdobeManual` のページ400の表1.76を参照してください。

en: A list containing a variable number of point ("vertices") coordinates (each given by a pair of floats) for various types of annotations:
ja: さまざまな種類の注釈に対する、可変数の点（"頂点"）座標（各々が浮動小数点数のペアで指定される）を含むリスト：

en: 'Line' -- the starting and ending coordinates (2 float pairs).
ja: 'Line' – 開始座標と終了座標（2つの浮動小数点数のペア）。

en: 'FreeText' -- 2 or 3 float pairs designating the starting, the (optional) knee point, and the ending coordinates.
ja: 'FreeText' – 開始座標、（オプションの）曲線点、および終了座標を指定する2または3つの浮動小数点数のペア。

en: 'PolyLine' / 'Polygon' -- the coordinates of the edges connected by line pieces (n float pairs for n points).
ja: 'PolyLine' / 'Polygon' – 線分で接続されたエッジの座標（nポイントのためのn個の浮動小数点数のペア）。

en: text markup annotations -- 4 float pairs specifying the *QuadPoints* of the marked text span (see :ref:`AdobeManual`, page 403).
ja: テキストのマークアップ注釈 – マークされたテキストスパンのQuadPointsを指定する4つの浮動小数点数のペア（Adobe PDFリファレンス、ページ403を参照）。

en: 'Ink' -- list of one to many sublists of vertex coordinates. Each such sublist represents a separate line in the drawing.
ja: 'Ink' – 頂点座標の1つから多数のサブリストのリスト。各サブリストは、描画内の別々の線を表します。

en: 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.
ja: *0 <= 浮動小数点数 <= 1の範囲内* で指定された "ストローク" および内部（"塗りつぶし"）カラーの2つの浮動小数点数のリストから成る辞書。ストロークカラーは、境界線やアクティブに塗装されたり書かれたりするすべてに使用されます。塗りつぶしカラーは、線の端、円、正方形などのオブジェクトの内部に使用されます。これらのリストの長さは、暗黙的に使用されるカラースペースを決定します：1 = GRAY、3 = RGB、4 = CMYK。したがって、"[1.0, 0.0, 0.0]" はRGBカラーの赤を表します。どちらのリストも指定されていない場合、空にすることができます。

en: The PDF :data:`xref`.
ja: PDFの :data:`xref` 。

en: The PDF :data:`xref` of an annotation to which this one responds. Return zero if this is no response annotation.
ja: この注釈が応答する注釈のPDF :data:`xref` 。これが応答注釈でない場合はゼロを返します。

en: The PDF :data:`xref` of the associated Popup annotation. Zero if non-existent.
ja: 関連するポップアップ注釈のPDF :data:`xref` 。存在しない場合はゼロ。

en: Whether the annotation has a Popup annotation.
ja: 注釈にポップアップ注釈があるかどうか。

en: Whether the annotation's Popup is open -- **or** the annotation itself ('Text' annotations only).
ja: 注釈のポップアップが開いているかどうか - **または** 注釈自体（'テキスト'注釈のみ）。

en: The rectangle of the associated Popup annotation. Infinite rectangle if non-existent.
ja: 関連するポップアップ注釈の矩形。存在しない場合は無限の矩形。

en: 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`.
ja: 注釈の `/RD` エントリを表す4つの浮動小数点数のタプル。これらの4つの数値は、2つの矩形間の数値の差（左、上、-右、-下）を説明しています：注釈の :attr:`rect` とその矩形内に含まれる矩形。エントリが存在しない場合、このプロパティは.  `（0、0、0、0）` です。注釈の境界線が通常のまっすぐな線である場合、これらの数値は通常、境界線の幅を2で割ったものです。注釈に「雲状」の境界線がある場合、ここで雲の半円の幅が表示されます。一般的に、これらの数値は同一である必要はありません。内側の矩形を計算するには、`a.rect + a.rect_delta` を使用します。

en: A dictionary containing border characteristics. Empty if no border information exists. The following keys may be present:
ja: 境界線の特性を含む辞書。境界線情報が存在しない場合は空です。次のキーが存在する可能性があります：

en: *width* -- a float indicating the border thickness in points. The value is -1.0 if no width is specified.
ja: *width*  – ポイントでの境界線の太さを示す浮動小数点数。幅が指定されていない場合、値は -1.0 です。

en: *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.
ja: *dashes* – ラインダッシングパターンを指定する整数のシーケンス。*[]* はダッシュなし、*[n]* は *n* ポイントの等しいオンオフの長さを意味し、より長いリストは交互のオンオフ長さ値を指定して解釈されます。詳細については、:ref:`AdobeManual` のページ126を参照してください。

en: *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.
ja: *style* – 1バイトの境界線スタイル： **"S"** （Solid）= 注釈を囲む実線、 **"D"** （Dashed）= 注釈を囲む破線、破線パターンは *dashes* エントリによって指定され、 **“B”** （Beveled）= ページの表面よりも上に浮かぶように見える模擬的な浮き出し矩形、 **"I"** （Inset）= ページの表面よりも下に凹んだように見える模擬的な浮き彫りの矩形、 **"U"** （Underline）= 注釈矩形の底部に沿った単一の線。

en: *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.
ja: *clouds* – “雲状”の境界を示す整数。``n`` は整数 `-1 <= n <= 2` を指します。値 `n = 0` は直線（雲なし）を示し、1 は小さな半円、2 は大きな半円を模倣した雲の外観を示します。-1 の場合、仕様が存在しないことを示します。

en: Annotation Icons in MuPDF
ja: MuPDFの注釈アイコン

en: 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'.
ja: これは「Text」および「FileAttachment」注釈タイプの名前で参照可能なアイコンのリストです。注釈を追加する際に*icon* パラメータを使用したり、:meth:`Annot.set_name` の引数として使用したりできます。どのアイテムを選択するかはあなたの裁量に任されています - たとえば、「Speaker」アイコンを「FileAttachment」に使用することを防ぐメカニズムは存在しません。

en: Example
ja: 例

en: Change the graphical image of an annotation. Also update the "author" and the text to be shown in the popup window::
ja: 注釈のグラフィカルな画像を変更します。また、ポップアップウィンドウに表示される「著者」とテキストを更新します。

en: This is how the circle annotation looks like before and after the change (pop-up windows displayed using Nitro PDF viewer):
ja: これが、変更前と変更後のサークル注釈の見た目です（Nitro PDFビューアを使用して表示されるポップアップウィンドウ）:

en: Footnotes
ja: 脚注

en: 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.
ja: 注釈を回転させると、その矩形も変更されます。注釈がどのように定義されたかによって、元の矩形は回転値を再びゼロに設定しても **再構築できず** 、失われます。

en: Only the following annotation types support method :meth:`Annot.set_rect`: Text, FreeText, Square, Circle, Redact, Stamp, Caret, FileAttachment, Sound, and Movie.
ja: :meth:`Annot.set_rect` をサポートする注釈タイプは、次のものだけです：Text、FreeText、Square、Circle、Redact、Stamp、Caret、FileAttachment、Sound、およびMovie。

en: This documentation covers all versions up to |version|.
ja: このドキュメントは |version| までのすべてのバージョンを対象としています。
