PyMuPDF 1.23.0rc1 - en to ja translation catalogue (178 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: Shape
ja: Shape（シェイプ）

en: 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.
ja: このクラスは、PDFページ上で相互に接続されたグラフィカル要素を作成できるようにします。このクラスのメソッドは、対応する :ref:`Page` クラスのメソッドと同じ意味と名前を持っています。

en: 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.
ja: 実際には、各 :ref:`Page` クラスの描画メソッドは、（1）シェイプの描画メソッド、（2）:meth:`Shape.finish` メソッド、（3）:meth:`Shape.commit` メソッドの3つの要素の便利なラッパーです。ページテキストの挿入に関しては、:meth:`Shape.commit` メソッドのみが呼び出されます。ページで多くの描画およびテキスト操作を実行する場合、常にShapeオブジェクトの使用を検討することをお勧めします。

en: 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.
ja: このクラスのいくつかの描画メソッドは、連続して実行でき、それぞれが1つの描画に貢献します。描画が完了したら、:meth:`Shape.finish` メソッドを呼び出して色、破線、幅、変形などの属性を適用する必要があります。

en: **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`.
ja: このクラスの **描画** メソッド（および:meth:`Shape.insert_textbox`）は、カバーしている領域を矩形 (:attr:`Shape.rect`)で記録します。このプロパティは、:attr:`Page.cropbox_position` を設定するために使用できます。

en: **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.
ja: **テキストの挿入** 操作である :meth:`Shape.insert_text` および :meth:`Shape.insert_textbox` は、暗黙的に「finish」を実行し、効果を発揮するために :meth:`Shape.commit` のみが必要です。その結果、両方のメソッドには色などのプロパティを制御するためのパラメータが含まれています。

en: **Method / Attribute**
ja: **メソッド / 属性**

en: **Description**
ja: **説明**

en: update the page's contents
ja: ページの内容を更新します

en: draw a cubic Bezier curve
ja: キュービックベジエ曲線を描画します

en: draw a circle around a point
ja: 指定した点を中心に円を描画します

en: draw a cubic Bezier using one helper point
ja: ヘルパーポイントを使用してキュービックベジエ曲線を描画します

en: draw a line
ja: 直線を描画します

en: draw an ellipse
ja: 楕円を描画します

en: connect a sequence of points
ja: 一連の点を接続します

en: draw a quadrilateral
ja: 四角形を描画します

en: draw a rectangle
ja: 長方形を描画します

en: draw a circular sector or piece of pie
ja: 円形セクターまたはパイの一部を描画します

en: draw a squiggly line
ja: 波線を描画します

en: draw a zigzag line
ja: ジグザグ線を描画します

en: finish a set of draw commands
ja: 描画コマンドのセットを完了します

en: insert text lines
ja: テキスト行を挿入します

en: fit text into a rectangle
ja: テキストを長方形に合わせて挿入します

en: stores the page's document
ja: ページのドキュメントを格納します

en: draw commands since last :meth:`Shape.finish`
ja: :meth:`Shape.finish` 以降の描画コマンドを格納します

en: stores the page's height
ja: ページの高さを格納します

en: stores the current point
ja: 現在のポイントを格納します

en: stores the owning page
ja: 所有するページを格納します

en: rectangle surrounding drawings
ja: 描画を囲む長方形を格納します

en: accumulated text insertions
ja: 累積テキスト挿入を格納します

en: accumulated string to be stored in :data:`contents`
ja: :data:`contents` に格納する累積文字列を格納します

en: stores the page's width
ja: ページの幅を格納します

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

en: 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.
ja: 新しい描画を作成します。PyMuPDFをインポートする際、*fitz.Page* オブジェクトには *Shape* オブジェクトを構築するための便利なメソッド *new_shape()* が提供されます。インスタンス化中に、PDFページが存在するかどうかのチェックが行われます。それ以外の場合は例外が発生します。

en: Parameters
ja: パラメータ

en: an existing page of a PDF document.
ja: PDFドキュメントの既存のページ。

en: Draw a line from :data:`point_like` objects *p1* to *p2*.
ja: :data:`point_like` オブジェクト *p1* から *p2* への直線を描画します。

en: starting point
ja: 開始点

en: end point
ja: 終了点

en: Return type
ja: 戻り値の型

en: Returns
ja: 戻り値

en: the end point, *p2*.
ja: 終了点 *p2*。

en: 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".
ja: :data:`point_like` オブジェクト *p1* から *p2* への波線（うねり、曲線）を描画します。常に整数回の完全な波の周期が描画され、1つの周期の長さは4 * breadthです。必要に応じて幅パラメータが調整され、この条件を満たします。描かれる線は常に *p1* を離れる際に「左」に曲がり、*p2* には常に「右」から接続します。

en: 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.
ja: 各波の振幅。条件 *2 * breadth < abs(p2 - p1)* が少なくとも1つの波に収まる必要があります。次の図は、1つの完全な周期で接続された2つの点を示しています。

en: Here is an example of three connected lines, forming a closed, filled triangle. Little arrows indicate the stroking direction.
ja: 以下は、閉じた塗りつぶされた三角形を形成する三つの連結した線の例です。小さな矢印はストロークの方向を示しています。

en: Waves drawn are **not** trigonometric (sine / cosine). If you need that, have a look at `draw.py <https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/draw-sines/draw.py>`_.
ja: 描かれる波は三角関数（正弦/余弦）**ではありません**。それが必要な場合は `draw.py <https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/draw-sines/draw.py>`_ を参照してください。

en: Draw a zigzag line from :data:`point_like` objects *p1* to *p2*. Otherwise works exactly like :meth:`Shape.draw_squiggle`.
ja: :data:`point_like` オブジェクト *p1* から *p2* へジグザグのラインを描画します。それ以外は :meth:`Shape.draw_squiggle` とまったく同じです。

en: the amplitude of the movement. The condition *2 * breadth < abs(p2 - p1)* must be true to fit in at least one period.
ja: 動きの振幅。1つの周期に収まるように振幅を調整します。条件は *2 * breadth < abs(p2 - p1)* である必要があります。

en: 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.
ja: シーケンス *points* に含まれるポイント間にいくつかの接続されたラインを描画します。これを使用して、最後のアイテムを最初のアイテムと等しく設定することで、任意の多角形を作成できます。

en: a sequence of :data:`point_like` objects. Its length must at least be 2 (in which case it is equivalent to *draw_line()*).
ja: :data:`point_like` オブジェクトのシーケンス。その長さは少なくとも2である必要があります（この場合、*draw_line()* と同等です）。

en: *points[-1]* -- the last point in the argument sequence.
ja: 引数シーケンスの最後のポイント、*points[-1]*。

en: Draw a standard cubic Bézier curve from *p1* to *p4*, using *p2* and *p3* as control points.
ja: *p1* から *p4* への標準的な立方ベジエ曲線を *p2*と *p3* を制御ポイントとして描画します。

en: All arguments are :data:`point_like` \s.
ja: すべての引数は :data:`point_like` です。

en: the end point, *p4*.
ja: 終了点 *p4*。

en: The points do not need to be different -- experiment a bit with some of them being equal!
ja: ポイントは異なる必要はありません。一部のポイントが等しい場合も試してみてください！

en: Example:
ja: 例：

en: 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.
ja: 指定された四角形（四辺形）内に「楕円」を描画します。正方形の場合、正円が描かれ、一般的な長方形は楕円になります。四角形が使用される場合、さまざまな形状が結果として得られる可能性があります。

en: The drawing starts and ends at the middle point of the line `bottom-left -> top-left` corners in an anti-clockwise movement.
ja: 描画は、反時計回りの動きで、左下隅 -> 左上隅の中間点で開始し、終了します。

en: :data:`rect_like` or :data:`quad_like`.
ja: :data:`rect_like` または :data:`quad_like`。

en: *Changed in version 1.14.5:*  Quads are now also supported.
ja: *バージョン1.14.5で変更：* 四角形もサポートされるようになりました。

en: 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.
ja: `rect.bl -> rect.tl` 、または `quad.ll -> quad.ul` の線の中間点。いくつかの例はこちら、またはPyMuPDF-Utilitiesリポジトリの *quad-show?.py* スクリプトをご覧ください。

en: 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.
ja: 指定された中心と半径で円を描きます。描画は、**反時計回り** の動きで、ポイント `center - (radius, 0)` で始まり、終了します。このポイントは、包括的な正方形の左側の中央です。

en: 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.
ja: これは  `draw_sector(center, start, 360, fullSector=False)` のショートカットです。**時計回り** に同じ円を描画するには、度数として -360 を使用してください。

en: the center of the circle.
ja: 円の中心。

en: the radius of the circle. Must be positive.
ja: 円の半径。正である必要があります。

en: 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).
ja: *draw_bezier()* の特殊なケース: *p1* から *p3* までの三次ベジエ曲線を描きます。各ライン `p1 -> p2` および `p3 -> p2` に制御点が生成されます。したがって、両方の制御点はライン `p1 -> p3` の同じ側にあります。これにより、曲線の曲率が符号を変更しないことが保証されます。p2 へのラインが90度で交差する場合、結果の曲線は四分の楕円（同じ長さの場合は四半期の円）です。

en: All arguments are :data:`point_like`.
ja: すべての引数は :data:`point_like` です。

en: the end point, *p3*. The following is a filled quarter ellipse segment. The yellow area is oriented **clockwise:**
ja: 終点、p3。以下は塗りつぶされた四分の楕円セグメントです。黄色の領域は **時計回り** に向いています：

en: Draw a circular sector, optionally connecting the arc to the circle's center (like a piece of pie).
ja: 円のセクタを描き、必要に応じて円の中心に弧を接続します（パイの一片のように）。

en: one of the two end points of the pie's arc segment. The other one is calculated from the *angle*.
ja: パイの弧セグメントの2つの端点のうちの1つ。*角度* から他の端点が計算されます。

en: 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.
ja: その符号に応じて、弧は反時計回り（正の値）または時計回りに描かれます。

en: 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.
ja: 弧の端点から円の中心に接続線を描くかどうか。塗りつぶし色が指定されている場合、完全な「パイ」が色付けされ、それ以外の場合はセクタのみが色付けされます。

en: the other end point of the arc. Can be used as starting point for a following invocation to create logically connected pies charts. Examples:
ja: 弧のもう一方の端点。論理的に接続されたパイチャートを作成するための次の呼び出しの開始点として使用できます。以下は例です：

en: Changed in v1.22.0: Added parameter *radius*.
ja: 変更された v1.22.0 で：パラメーター *radius* が追加されました。

en: Draw a rectangle. The drawing starts and ends at the top-left corner in an anti-clockwise movement.
ja: 長方形を描画します。描画は、上部左隅から反時計回りの動きで始まり、終了します。

en: where to put the rectangle on the page.
ja: ページ上の長方形の配置先。

en: 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.
ja: 角の丸みを付けた長方形を描画します。`None` でない場合、曲線の半径を長方形の辺の長さのパーセンテージとして指定します。これは 1 つまたは 2 つの浮動小数点数、`0 < radius <= 0.5` でなければなりません。0.5 は、対応する辺の 50% に相当します。浮動小数点数の場合、曲線の半径は `radius * min(width, height)` として計算され、角の周囲を 1/4 円で描画します。タプル `(rx, ry)` が指定された場合、曲線は水平および垂直方向に対して非対称です。`radius=(0.5, 0.5)` は楕円を描画します。

en: top-left corner of the rectangle.
ja: 長方形の上部左隅。

en: 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)`.
ja: 四角形を描画します。描画は、上部左隅 (:attr:`Quad.ul`) から反時計回りの動きで始まり、終了します。これは :meth:`Shape.draw_polyline` の引数 `(ul, ll, lr, ur, ul)` を使用したショートカットです。

en: where to put the tetragon on the page.
ja: ページ上の四角形の配置先。

en: Finish a set of *draw*()* methods by applying :ref:`CommonParms` to all of them.
ja: 次の *draw*()* メソッドの一連の描画を、:ref:`CommonParms` をそれらすべてに適用して終了します。

en: It has **no effect on** :meth:`Shape.insert_text` and :meth:`Shape.insert_textbox`.
ja: :meth:`Shape.insert_text` および:meth:`Shape.insert_textbox` には **影響を与えません**。

en: The method also supports **morphing the compound drawing** using :ref:`Point` *fixpoint* and :ref:`matrix` *matrix*.
ja: このメソッドは、:ref:`Point` *fixpoint* と :ref:`matrix` *matrix* を使用して、テキストまたは **複合描画を変形させること** もサポートしています。

en: 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.
ja: テキストまたは複合描画を、任意の :ref:`Point` *fixpoint* に :ref:`Matrix` *matrix* を適用して変形します。これにより、*fixpoint* はこの操作の **固定ポイント** であることを意味します。その位置は変わりません。デフォルトは変形なし（*None*）です。ただし、matrixの最初の4つの成分には任意の値を含めることができ、*matrix.e == matrix.f == 0* である必要があります。これは、スケーリング、シアリング、回転、反転など、移動以外の組み合わせが可能であることを意味しますが、移動はできません。

en: *(new in v1.18.1)* set transparency for stroke colors. Value < 0 or > 1 will be ignored. Default is 1 (intransparent).
ja: *（v1.18.1で新規追加）* ストロークの透明度を設定します。値が0未満または1を超える場合は無視されます。デフォルトは1（不透明）です。

en: *(new in v1.18.1)* set transparency for fill colors. Default is 1 (intransparent).
ja: *（v1.18.1で新規追加）* 塗りつぶしの色の透明度を設定します。デフォルトは1（不透明）です。

en: 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.
ja: 塗りつぶし操作に対して **「even-oddルール」** を要求します。デフォルトは *False* で、したがって **「非ゼロのワインディング数ルール」** が使用されます。これらのルールは、領域が重なる場所で塗りつぶし色を適用するための代替メソッドです。複雑な形状では、これらのルールに異なる振る舞いが期待されることはほとんどありません。詳細な説明については、:ref:`AdobeManual` の137ページ以降を参照してください。以下はその違いを示す例です。

en: *(new in v1.18.4)* the :data:`xref` number of an :data:`OCG` or :data:`OCMD` to make this drawing conditionally displayable.
ja: *（v1.18.4で新規追加）* この描画を条件付きで表示可能にする :data:`OCG` または :data:`OCMD` の :data:`xref` 番号。

en: For each pixel in a shape, the following will happen:
ja: 各ピクセルの場合、以下のことが起こります：

en: 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**.
ja: ルール **「even-odd」** は、ピクセルを含むエリアの数をカウントします。このカウントが **奇数** の場合、ピクセルは形状の **内部** と見なされ、偶数の場合は **外部** と見なされます。

en: 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.
ja: デフォルトのルール **「nonzero winding」** では、ピクセルを含む各エリアの *「方向」* も考慮されます。エリアが反時計回りに描かれている場合は **1を追加し** 、時計回りのエリアは **1を引きます** 。結果がゼロの場合、ピクセルは **外部** と見なされ、非ゼロのカウントを持つピクセルは形状の **内部** と見なされます。

en: 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).
ja: 上記の画像の4つの形状のうち、上の2つはそれぞれ標準的な方法で描かれた3つの円を示しています（反時計回り、矢印を参照）。下の2つの形状には時計回りに描かれた1つ（左上）の円が含まれています。右の列では、エリアの方向は無視されることがわかります（even-oddルール）。

en: Insert text lines start at *point*.
ja: テキスト行を *point* で開始します。

en: 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.
ja: テキストの最初の文字の下部左位置（ピクセル単位）。*rotate* パラメータとの連携方法を理解することが重要です。以下の画像をご覧ください。小さな赤い点は、各ケースでの *point* の位置を示しています。

en: 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.
ja: 挿入するテキスト。文字列型または文字列のシーケンス型として指定できます。シーケンスの場合、または改行文字 *\n* を含む文字列の場合、複数の行が挿入されます。ただし、行があまりにも幅が広い場合、挿入される行数はページ上の「垂直」スペース（*回転* パラメータによって確立される読み取り方向の意味で）によって制限されます。*テキスト* の残り部分は破棄されますが、戻りコードには挿入された行数が含まれます。

en: *(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.
ja: *（v1.18.1で新たに追加）* 塗りつぶしカラーの透明度を設定します。デフォルトは1（不透明）です。テキストカラーの透明度を制御するためにこの値を使用します。ストロークの透明度は文字の境界線に **のみ** 影響します。

en: *(new in v1.18.4)* the :data:`xref` number of an :data:`OCG` or :data:`OCMD` to make this text conditionally displayable.
ja: *(v1.18.4 新機能)* :data:`OCG` または :data:`OCMD` の :data:`xref` 番号、テキストを条件付きで表示可能にするためのものです。

en: number of lines inserted.
ja: 挿入された行数。

en: For a description of the other parameters see :ref:`CommonParms`.
ja: 他のパラメータの説明については  :ref:`CommonParms` を参照してください。

en: the area to use. It must be finite and not empty.
ja: 使用する領域。有限でかつ空でなければなりません。

en: 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.
ja: 挿入するテキスト。文字列または文字列のシーケンスとして指定する必要があります。シーケンスエントリ内の行送りも尊重されます。

en: 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`).
ja: 各テキスト行を整列させます。デフォルトは0（左揃え）。センタリング、右揃え、ジャスティファイドがサポートされている他のオプションです。詳細は :ref:`TextAlign` を参照してください。なお、パラメータ値  *TEXT_ALIGN_JUSTIFY* の効果は、「シンプル」（単一バイト）フォント（:ref:`Base-14-Fonts` を含む）でのみ達成できます。

en: *(new in v1.18.1)* set transparency for stroke colors. Negative values and values > 1 will be ignored. Default is 1 (intransparent).
ja: *（v1.18.1で新たに追加）* ストロークカラーの透明度を設定します。負の値や1より大きい値は無視されます。デフォルトは1（不透明）です。

en: **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.
ja: **正またはゼロの場合** ：正常な実行。返される値は使用されていない矩形行のスペース（ピクセル単位）です。これを安全に無視するか、矩形を最適化したり、後続のアイテムの位置を調整したりするために使用できます。

en: **If negative**: no execution. The value returned is the space deficit to store text lines. Enlarge rectangle, decrease *fontsize*, decrease text amount, etc.
ja: **負の場合**： 実行なし。返される値はテキスト行を格納するためのスペース不足です。矩形を拡大したり、フォントサイズを減少させたり、テキストの量を減少させたりする必要があります。

en: 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.
ja: ページの :data:`contents` を蓄積された描画に更新し、その後テキスト挿入が続きます。テキストが描画と重なる場合、テキストは描画の上に書き込まれます。

en: **Do not forget to execute this method:**
ja: **このメソッドを実行しないことは忘れないでください：**

en: If a shape is **not committed, it will be ignored and the page will not be changed!**
ja: シェイプが **確定されていない** 場合、無視され、ページは変更されません！

en: 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**.
ja: このメソッドは、属性 :attr:`Shape.rect`、:attr:`lastPoint` 、:attr:`draw_cont` 、:attr:`text_cont` 、および :attr:`totalcont` をリセットします。その後、シェイプオブジェクトは **同じページ** で再利用できます。

en: determine whether to put content in foreground (default) or background. Relevant only, if the page already has a non-empty :data:`contents` object.
ja: コンテンツを前面（デフォルト）または背面に配置するかどうかを決定します。ページに既存の非空の :data:`contents` オブジェクトがある場合のみ関連します。

en: **---------- Attributes ----------**
ja: **属性**

en: For reference only: the page's document.
ja: 参照専用：ページの文書。

en: For reference only: the owning page.
ja: 参照専用：所属するページ。

en: Copy of the page's height
ja: ページの高さのコピー

en: Copy of the page's width.
ja: ページの幅のコピー。

en: Accumulated command buffer for **draw methods** since last finish. Every finish method will append its commands to :attr:`Shape.totalcont`.
ja: 最後のfinish以降の **描画メソッド** の蓄積コマンドバッファ。各finishメソッドはそのコマンドを :attr:`Shape.totalcont` に追加します。

en: 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.
ja: 蓄積されたテキストバッファ。すべての **テキスト挿入** はここに行われます。このバッファは :attr:`totalcont` :meth:`Shape.commit` に追加されるため、テキストは同じShape内の描画に覆われることはありません。

en: 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.
ja: 描画を囲む矩形。この属性はあなたの自由に使用でき、いつでも変更できます。シェイプが作成または確定されたとき、その値は *None* に設定されます。すべての *draw** メソッド、および :meth:`Shape.insert_textbox` はこのプロパティを更新します（必要に応じて矩形を **拡大します** ）。ただし、**変形** 操作（:meth:`Shape.finish` 、:meth:`Shape.insert_textbox` ）は無視されます。

en: 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.
ja: この属性の典型的な使用法は、後でまたは外部で使用するためにシェイプを作成する場合、:attr:`Page.cropbox_position` をこの値に設定することです。自分で属性を操作していない場合、これはこれまでのすべての描画を含む矩形を反映するはずです。

en: If you have used morphing and need a rectangle containing the morphed objects, use the following code::
ja: 変形を使用し、変形されたオブジェクトを含む矩形が必要な場合、次のコードを使用します::

en: Total accumulated command buffer for draws and text insertions. This will be used by :meth:`Shape.commit`.
ja: 描画およびテキスト挿入のための累積コマンドバッファです。これは :meth:`Shape.commit` で使用されます。

en: For reference only: the current point of the drawing path. It is *None* at *Shape* creation and after each *finish()* and *commit()*.
ja: 参照用: 描画パスの現在のポイントです。*Shape* の作成時、および各 *finish()* および *commit()* の後には *None* です。

en: Usage
ja: 使用法

en: 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::
ja: drawingオブジェクトは `shape = page.new_shape()` によって構築されます。その後、必要なだけ多くのdraw、finish、およびテキスト挿入メソッドが続きます。描画をコミットする前に、各描画シーケンスを終了する必要があります。全体のコーディングパターンは次のようになります::

en: 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.
ja: 各 *finish()* メソッドは、前の描画を1つの論理的なシェイプに結合し、共通の色、線の幅、変形などを設定します。*closePath* が指定されている場合、最後の描画のエンドポイントを最初の描画のスタートポイントと接続します。

en: 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).
ja: 複合グラフィックを正常に作成するには、各 draw メソッドが前の描画のエンドポイントを次の描画のスタートポイントとして使用してください。上記の疑似コードでは、*draw2* は *draw1* の戻り値である :ref:`Point` を次の描画のスタートポイントとして使用すべきです。そうしないと、自動的に新しいパスが開始され、*finish()* が期待どおりに動作しないかもしれません（ただし、エラーは発生しません）。

en: 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*.
ja: テキストの挿入は、コミット（commit）の前にどこでも発生できます :attr:`Shape.draw_cont` または :attr:`Shape.lastPoint` に触れません）。テキストは直接 *Shape.totalcont* に追加されますが、描画は *Shape.finish* によって追加されます。

en: 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.
ja: 各 *コミット* は、すべてのテキスト挿入とシェイプをページの前面または背面に配置し、グラフィックのレイヤーを制御する方法を提供します。

en: **Only** *commit* **will update** the page's contents, the other methods are basically string manipulations.
ja: *コミット* **のみ** がページのコンテンツを **更新します**。他のメソッドは基本的に文字列の操作です。

en: Examples
ja: 例

en: Create a full circle of pieces of pie in different colors::
ja: 異なる色のピースを使用して円形のパイを作成します::

en: Here is an example for 5 colors:
ja: 以下は5つの色の例です。

en: 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::
ja: 正則なn角形を作成します（塗りつぶしは黄色、赤い境界線）。周囲の点を計算するために *draw_sector（）* を使用し、多角形を描く前に描画コマンドバッファを空にします::

en: Here is the polygon for n = 7:
ja: n = 7の場合の多角形は次のとおりです：

en: Common Parameters
ja: 共通パラメータ

en: In general, there are three options:
ja: 一般的に、3つのオプションがあります：

en: 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.
ja: 標準の :ref:`Base-14-Fonts` のいずれかを使用します。この場合、*fontfile* を指定 **してはいけず**、このパラメータを省略した場合は *「Helvetica」* が使用されます。

en: Choose a font already in use by the page. Then specify its **reference** name prefixed with a slash "/", see example below.
ja: 既にページで使用されているフォントを選択します。その場合、スラッシュ「/」で前置された **参照** 名を指定します。以下の例を参照してください。

en: Specify a font file present on your system. In this case choose an arbitrary, but new name for this parameter (without "/" prefix).
ja: システムに存在するフォントファイルを指定します。この場合、任意の新しい名前をこのパラメータに選択します（「/」接頭辞なし）。

en: If inserted text should re-use one of the page's fonts, use its reference name appearing in :meth:`Page.get_fonts` like so:
ja: 挿入されるテキストがページのフォントの1つを再利用する場合は、:meth:`Page.get_fonts` に表示される参照名を次のように使用します：

en: Suppose the font list has the item *[1024, 0, 'Type1', 'NimbusMonL-Bold', 'R366']*, then specify *fontname = "/R366", fontfile = None* to use font *NimbusMonL-Bold*.
ja: フォントリストに項目 *[1024, 0, 'Type1', 'NimbusMonL-Bold', 'R366']* がある場合、フォント *NimbusMonL-Bold*  を使用するには、*fontname = "/R366"、fontfile = None* と指定します。

en: 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.
ja: コンピューターに存在するフォントのファイルパス。*fontfile* を指定する場合、上記のリストに **存在しない** *フォント名* を使用してください。この新しいフォントは、*doc.save()* 時にPDFに埋め込まれます。画像と同様に、フォントファイルは1度だけ埋め込まれます。バイナリフォントコンテンツのMD5コードのテーブルが使用され、これを確実にします。

en: 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.
ja: ファイルからインストールされたフォントは、デフォルトで **Type0** フォントとしてインストールされます。1バイト文字のみを使用する場合は、これをtrueに設定します。この設定は元に戻すことはできません。後続の変更は無視されます。

en: Font size of text, see: :data:`fontsize`.
ja: テキストのフォントサイズ、参照： :data:`fontsize`。

en: 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`.
ja: 線を破線で描画するようにします。一般的なフォーマットは、ピクセル長を示す（最大）3つの浮動小数点数の `"[n m] p"` です。``n`` は破線の長さ、``m`` （オプション）はその後のギャップの長さ、 ``p`` （「位相」 - 0であっても **必須**！）は、破線が開始される前にスキップするべきピクセルの数を指定します。``m`` が省略された場合、``n`` にデフォルト値が設定されます。

en: A continuous line (no dashes) is drawn with `"[] 0"` or *None* or `""`. Examples:
ja: 連続線（破線なし）は `"[] 0"` または *None* または `""` で描画されます。例：

en: Specifying `"[3 4] 0"` means dashes of 3 and gaps of 4 pixels following each other.
ja: `"[3 4] 0"` を指定すると、3ピクセルの破線と4ピクセルのギャップが交互に続きます。

en: `"[3 3] 0"` and `"[3] 0"` do the same thing.
ja: `"[3 3] 0"` と `"[3] 0"` は同じことをします。

en: For (the rather complex) details on how to achieve sophisticated dashing effects, see :ref:`AdobeManual`, page 217.
ja: 洗練された破線効果を実現する詳細な詳細については、:ref:`AdobeManual` の217ページを参照してください。

en: **color / fill** (*list, tuple*)
ja: **色/塗りつぶし** （*リスト、タプル*）

en: 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.
ja: 線の色と塗りつぶしの色は、0から1までの浮動小数点数からなるリストまたはタプルとして指定できます。これらのシーケンスの長さは、1（GRAY）、3（RGB）、または4（CMYK）でなければなりません。GRAYカラースペースの場合、*[float]* や*(float,)* の代わりに単一の浮動小数点数を使用することもできます。このパラメータを受け入れるには、（デフォルト）を受け入れるか、または使用しないようにするには `None` を使用します。

en: 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`.
ja: 色の指定を簡略化するために、*fitz.utils* の *getColor()* メソッドを使用して、名前に対応するRGBカラートリプルを取得することができます。これは色の名前を指定する文字列を受け入れ、対応するトリプルを返します。このメソッドは540以上のカラー名を認識します。:ref:`ColorDatabase` のセクションを参照してください。

en: Please note that the term *color* usually means "stroke" color when used in conjunction with fill color.
ja: ご注意ください。*色* という用語は、通常、塗りつぶし色と組み合わせて使用される場合に「線の」色を意味します

en: 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.
ja: 色パラメータのデフォルト値を `None` にする場合、対応する色の選択コマンドは生成されません。*fill* と *color* がどちらも `None` の場合、描画には色の指定が含まれません。ただし、まだ「ストローク」されているため、Adobe Acrobatや他のビューアではPDFのデフォルトカラー「ブラック」が使用されます。

en: **stroke_opacity / fill_opacity** (*floats*)
ja: **stroke_opacity / fill_opacity** （*浮動小数点数*）

en: 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.
ja: 両方の値は[0、1]の範囲の浮動小数点数です。負の値または1を超える値は（ほとんどの場合）無視されます。両方の値は、透明度を設定し、たとえば値0.5は50％の透明度を示し、0は不可視を意味し、1は不透明を意味します。たとえば四角形の場合、stroke_opacityはその境界に、fill_opacityはその内部に適用されます。

en: 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.
ja: テキストの挿入（:meth:`Shape.insert_text` および :meth:`Shape.insert_textbox` ）の場合、テキストには *fill_opacity* を使用してください。最初は驚くかもしれませんが、*render_mode* の詳細を見ると明らかになります。*fill_opacity* は黄色に適用され、*stroke_opacity* は青色に適用されます。

en: **border_width** (*float*)
ja: **border_width** （*浮動小数点数*）

en: 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.
ja: テキスト挿入の境界線の幅を設定します。v1.14.9で新しく追加されました。render_mode引数がゼロより大きい値で使用されている場合にのみ関連します。

en: **render_mode** (*int*)
ja: **render_mode** (*整数*)

en: *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.
ja: *バージョン1.14.9で新たに導入された* `range(8)` 内の整数。これはテキストの外観（:meth:`Shape.insert_text` および :meth:`Shape.insert_textbox` ）を制御します。:ref:`AdobeManual` のページ246を参照してください。バージョン1.14.9での新機能です。これらのメソッドは、塗りつぶしの色とストロークの色を区別するようになりました。

en: For default 0, only the text fill color is used to paint the text. For backward compatibility, using the *color* parameter instead also works.
ja: デフォルト値0では、テキストの塗りつぶし色のみがテキストを塗りつぶすために使用されます。*color* パラメーターを代わりに使用することも、後方互換性のために機能します。

en: 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.
ja: render_mode 1では、各グリフ（つまりテキスト文字）の境界線のみが指定された *border_width* で描画されます。この際、*color* 引数で選択した色が使用され、*fill* パラメーターは無視されます。

en: 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*.
ja: render_mode 2では、グリフは塗りつぶされ、ストロークされ、両方の色パラメーターと指定された境界幅が使用されます。別のフォントを使用せずに **太字のテキスト** をシミュレートするためにこの値を使用できます。*fill* と *color* に同じ値を選択し、*border_width* に適切な値を選択します。

en: For render mode 3, the glyphs are neither stroked nor filled: the text becomes invisible.
ja: render_mode 3では、グリフはストロークも塗りつぶしもされません。テキストは見えなくなります。

en: The following examples use border_width=0.3, together with a fontsize of 15. Stroke color is blue and fill color is some yellow.
ja: 以下の例では、border_width=0.3を使用し、フォントサイズは15です。ストロークの色は青で、塗りつぶしの色は黄色です。

en: **overlay** (*bool*)
ja: **オーバーレイ** （*bool*）

en: Causes the item to appear in foreground (default) or background.
ja: アイテムを前景（ デフォルト）または背景に表示させます。

en: **morph** (*sequence*)
ja: **morph** （*シーケンス*）

en: 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.
ja: *draw*()* メソッドによって作成されたシェイプまたはページメソッド *insert_textbox（）*/ *insert_text（）* によって挿入されたテキストのいずれかの「変形」を引き起こします。 *None* でない場合、*（fixpoint、matrix）* のペアでなければなりません。ここで、*fixpoint* は :ref:`Point` であり、*matrix* は :ref:`Matrix` です。行列は、*matrix.e == matrix.f == 0* でない限り、移動以外の任意のものにすることができます。ポイントは、行列操作の固定ポイントとして使用されます。たとえば、*行列* が回転またはスケーリングである場合、*fixpoint* はその中心です。同様に、*行列* が左右または上下の反転である場合、鏡像化される軸は *fixpoint* を介して通る垂直、または水平の線です。

en: 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.
ja: いくつかのメソッドには、ページに挿入されるアイテムが実際に適合するかどうかをチェックする検証が含まれています（:meth:`Shape.insert_text` 、または :meth:`Shape.draw_rect` など）。変形操作の結果にはそのような保証はありません。これは完全にプログラマーの責任です。

en: **lineCap (deprecated: "roundCap")** (*int*)
ja: **lineCap（非推奨：「roundCap」**）（*int*）

en: 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.
ja: 線の末端の外観を制御します。デフォルト値0は、各線の末端が鋭いエッジで正確な座標で終了することを許可します。値1は、末端に直径が線の幅で中心が末端ポイントである半円を追加します。値2は、線の幅と線の末端を中心とする辺の長さがある半正方形を追加します。

en: *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").
ja: *バージョン1.14.15で新規追加：* ラインの接続方法を制御します。これは、鋭いエッジ（0）、丸い接続（1）、または切り取られたエッジ（2、「butt」）のいずれかです。

en: Causes the end point of a drawing to be automatically connected with the starting point (by a straight line).
ja: 描画の終点を自動的に始点に直線で接続させる原因となります。

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