PyMuPDF 1.23.0rc1 - en to ja translation catalogue (236 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: 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 ...
ja: PyMuPDFでは、ピクセルマップを作成するためのいくつかの方法が存在します。最初の方法を除いて、すべての方法はオーバーロードされたコンストラクタとして使用できます。ピクセルマップは、以下の方法で作成できます...

en: from a document page (method :meth:`Page.get_pixmap`)
ja: ドキュメントページから（メソッド :meth:`Page.get_pixmap` を使用）

en: empty, based on :ref:`Colorspace` and :ref:`IRect` information
ja: :ref:`Colorspace` と :ref:`IRect` 情報に基づいて空のものを作成

en: from a file
ja: ファイルから

en: from an in-memory image
ja: メモリ内のイメージから

en: from a memory area of plain pixels
ja: 平易なピクセルのメモリ領域から

en: from an image inside a PDF document
ja: PDFドキュメント内のイメージから

en: as a copy of another pixmap
ja: 他のピクセルマップのコピーとして

en: A number of image formats is supported as input for points 3. and 4. above. See section :ref:`ImageFiles`.
ja: 3.と4.のポイントに対する入力として多くの画像フォーマットがサポートされています。サポートされている入力画像フォーマットの詳細については、:ref:`ImageFiles` のセクションを参照してください。

en: Have a look at the :ref:`FAQ` section to see some pixmap usage "at work".
ja: ピクセルマップの使用例については、:ref:`FAQ` セクションをご覧ください。

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

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

en: clear parts of the pixmap
ja: ピクセルマップの一部をクリアします。

en: determine used colors
ja: 使用された色を決定します。

en: determine share of most used color
ja: 最も使用される色のシェアを決定します。

en: copy parts of another pixmap
ja: 別のピクセルマップの一部をコピーします。

en: apply a gamma factor to the pixmap
ja: ピクセルマップにガンマ係数を適用します。

en: invert the pixels of a given area
ja: 指定された領域のピクセルを反転させます。

en: save the pixmap as an OCRed 1-page PDF
ja: OCR処理済みの1ページのPDFとしてピクセルマップを保存します。

en: save as image using pillow
ja: Pillowを使用してイメージとして保存します。

en: write to `bytes` object using pillow
ja: Pillowを使用してバイトオブジェクトに書き込みます。

en: return the value of a pixel
ja: ピクセルの値を返します。

en: save the pixmap in a variety of formats
ja: さまざまな形式でピクセルマップを保存します。

en: set alpha values
ja: アルファ値を設定します。

en: set the image resolution
ja: イメージの解像度を設定します。

en: set pixmap x,y values
ja: ピクセルマップのx、y値を設定します。

en: set color and alpha of a pixel
ja: ピクセルの色とアルファを設定します。

en: set color and alpha of all pixels in a rectangle
ja: 四角形内のすべてのピクセルの色とアルファを設定します。

en: reduce size keeping proportions
ja: 比率を保持しながらサイズを縮小します。

en: tint the pixmap
ja: ピクセルマップに色調を付けます。

en: return a memory area in a variety of formats
ja: さまざまな形式のメモリ領域を返します。

en: return a pixmap made from a quad inside
ja: 内部の四角形から作成されたピクセルマップを返します。

en: transparency indicator
ja: 透明度指示子

en: pixmap's :ref:`Colorspace`
ja: ピクセルマップの :ref:`Colorspace`

en: MD5 hashcode of the pixmap
ja: ピクセルマップのMD5ハッシュコード

en: pixmap height
ja: ピクセルマップの高さ

en: interpolation method indicator
ja: 補間メソッド指示子

en: check if only black and white occur
ja: 黒と白だけが存在するか確認します。

en: check if only one color occurs
ja: 単一の色しか存在しないか確認します。

en: :ref:`IRect` of the pixmap
ja: ピクセルマップの :ref:`IRect`

en: bytes per pixel
ja: ピクセルごとのバイト数

en: `memoryview` of pixel area
ja: ピクセル領域の `memoryview`

en: Python pointer to pixel area
ja: ピクセル領域へのPythonポインタ

en: `bytes` copy of pixel area
ja: ピクセル領域の `bytes` コピー

en: pixmap's total length
ja: ピクセルマップの合計長さ

en: size of one image row
ja: 1つの画像行のサイズ

en: pixmap width
ja: ピクセルマップの幅

en: X-coordinate of top-left corner
ja: 左上隅のX座標

en: resolution in X-direction
ja: X方向の解像度

en: Y-coordinate of top-left corner
ja: 左上隅のY座標

en: resolution in Y-direction
ja: Y方向の解像度

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

en: **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.
ja: **新しい空のピクマップ:** 指定された矩形のサイズと原点を持つ空のピクマップを作成します。したがって、*irect.top_left* はピクマップの左上隅を示し、その幅と高さは *irect.width* および *irect.height* です。イメージ領域は **初期化されず** 、データが格納されます。データを初期化するには、:meth:`clear_with` や :meth:`set_rect` などを使用してください。

en: colorspace.
ja: カラースペース。

en: The pixmap's position and dimension.
ja: ピクマップの位置と寸法。

en: Specifies whether transparency bytes should be included. Default is *False*.
ja: 透明度バイトを含めるかどうかを指定します。デフォルトは *False* です。

en: **Copy and set colorspace:** Copy *source* pixmap converting colorspace. Any colorspace combination is possible, but source colorspace must not be *None*.
ja: **コピーとカラースペースの設定:** カラースペースを変換しながら *ソース* ピクマップをコピーします。どのカラースペースの組み合わせでも可能ですが、ソースカラースペースは *None* であってはいけません。

en: the source pixmap.
ja: ソースピクマップ。

en: New in v1.18.18
ja: バージョン 1.18.18 で新規追加

en: **Copy and add image mask:** Copy *source* pixmap, add an alpha channel with transparency data from a mask pixmap.
ja: **コピーとイメージマスクの追加:** ソースピクマップをコピーし、マスクピクマップから透明度データを持つアルファチャネルを追加します。

en: pixmap without alpha channel.
ja: アルファチャネルを持たないピクマップ。

en: a mask pixmap. Must be a graysale pixmap.
ja: マスクピクマップ。グレースケールのピクマップである必要があります。

en: **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*.
ja: **コピーとスケーリング:** ソースピクマップをコピーし、新しい幅と高さの値にスケーリングします。イメージはそれに応じてストレッチまたは縮小されます。部分的なコピーをサポートしています。ソースカラースペースは *None* であってもかまいません。

en: desired target width.
ja: ターゲットの幅。

en: desired target height.
ja: ターゲットの高さ。

en: restrict the resulting pixmap to this region of the **scaled** pixmap.
ja: **スケーリングされた** ピクマップのこの領域に制限します。

en: If width or height do not *represent* integers (i.e. `value.is_integer() != True`), then the resulting pixmap **will have an alpha channel**.
ja: 幅または高さが整数を *表していない* 場合（つまり、`value.is_integer() != True` の場合）、結果のピクマップには **アルファチャンネルが含まれます** 。

en: **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.
ja: **コピーしてアルファの追加または削除：** *ソース* をコピーし、そのアルファチャンネルを追加または削除します。*alpha* が *source.alpha* と等しい場合、同一のコピーになります。アルファチャンネルが追加される場合、その値は255に設定されます。

en: source pixmap.
ja: ソースのピクマップ。

en: whether the target will have an alpha channel, default and mandatory if source colorspace is *None*.
ja: 対象にアルファチャンネルがあるかどうか、デフォルトで、ソースのcolorspaceが *None* の場合は必須です。

en: 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*:
ja: 典型的な使用例には、カラーと透明バイトを別々のピクマップに分離することが含まれます。一部のアプリケーションでは、*wxPython* の *wx.Bitmap.FromBufferAndAlpha()* など、これが必要です。

en: **From a file:** Create a pixmap from *filename*. All properties are inferred from the input. The origin of the resulting pixmap is *(0, 0)*.
ja: **ファイルから:** ファイル名から pixmap を作成します。すべてのプロパティは入力から推測されます。生成される pixmap の原点は *(0, 0)* です。

en: Path of the image file.
ja: 画像ファイルのパス。

en: **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)*.
ja: **メモリから:** メモリ領域から pixmap を作成します。すべてのプロパティは入力から推測されます。生成される pixmap の原点は *(0, 0)* です。

en: 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.
ja: 完全で有効な画像を含むデータ。例えば、*stream = bytearray(open('image.file', 'rb').read())* などで作成できます。Python 2 では *bytes* はサポートされていないため、**Python 3 のみ** 対応しています。なぜなら、Python 2 では *bytes == str* となり、このメソッドはストリームをファイル名と解釈する可能性があるからです。

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

en: **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`.
ja: **生のピクセルから:** *サンプル* から pixmap を作成します。各ピクセルは、*カラースペース* と *alpha* パラメーターによって制御されるバイト数で表現される必要があります。生成される pixmap の原点は *(0, 0)* です。このメソッドは、他のプログラムによって生の画像データが提供される場合に有用です - :ref:`FAQ` を参照してください。

en: Colorspace of image.
ja: 画像のカラースペース。

en: image width
ja: 画像の幅

en: image height
ja: 画像の高さ

en: an area containing all pixels of the image. Must include alpha values if specified.
ja: 画像のすべてのピクセルを含む領域。指定されている場合はアルファ値を含める必要があります。

en: *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.
ja: *バージョン 1.14.13 で変更:* (1) *io.BytesIO* も使用できるようになりました。 (2) データは pixmap に **コピーされる** ようになり、安全に削除または利用不可能になります。

en: whether a transparency channel is included.
ja: 透明チャネルを含めるかどうか。

en: The following equation **must be true**: *(colorspace.n + alpha) * width * height == len(samples)*.
ja: 以下の式が **成り立つ必要があります** : *(colorspace.n + alpha) * width * height == len(samples)*。

en: Starting with version 1.14.13, the samples data are **copied** to the pixmap.
ja: バージョン 1.14.13 以降、サンプルデータは pixmap に **コピーされます** 。

en: **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 <https://github.com/pymupdf/PyMuPDF/tree/master/demo/extract-img1.py>`_ and `extract-img2.py <https://github.com/pymupdf/PyMuPDF/tree/master/demo/extract-img2.py>`_ to see how this can be used to recover all of a PDF's images.
ja: **PDFイメージから：**  PDFドキュメント内の :data:`xref` で識別されるイメージからピクスマップを作成します。ピクスマップのすべてのプロパティはイメージによって設定されます。これがどのように使用されるかを確認するには、`extract-img1.py <https://github.com/pymupdf/PyMuPDF/tree/master/demo/extract-img1.py>`_ と `extract-img2.py <https://github.com/pymupdf/PyMuPDF/tree/master/demo/extract-img2.py>`_ をご覧ください。これにより、PDFのすべてのイメージを復元できます。

en: an opened **PDF** document.
ja: 開かれた **PDF** ドキュメント。

en: 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.
ja: 画像オブジェクトの :data:`xref`。たとえば、:meth:`Document.get_page_images` を使用して特定のページで使用されるすべてのイメージのリストを作成し、各イメージの :data:`xref` 番号も表示できます。

en: Initialize the samples area.
ja: サンプル領域を初期化します。

en: 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*.
ja: 指定された場合、0から255の値が有効です。各ピクセルの各カラーバイトはこの値に設定され、存在する場合はアルファが255（非透明）に設定されます。省略された場合、すべてのバイト（アルファを含む）が *0x00* にクリアされます。

en: the area to be cleared. Omit to clear the whole pixmap. Can only be specified, if *value* is also specified.
ja: クリアする領域。ピクスマップ全体をクリアするには省略します。*value* も指定されている場合のみ指定できます。

en: 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.
ja: ピクスマップを色付けして、黒と/または白を **sRGB整数値** として指定された色で置き換えます。:data:`CS_GRAY` と :data:`CS_RGB` のカラースペースのみサポートされており、他のカラースペースは警告付きで無視されます。

en: If the colorspace is :data:`CS_GRAY`, the average *(red + green + blue)/3* will be taken. The pixmap will be changed in place.
ja: カラースペースが :data:`CS_GRAY` の場合、平均（赤+緑+青）/3が取得されます。ピクスマップはその場で変更されます。

en: replace black with this value. Specifying 0x000000 makes no changes.
ja: 黒をこの値で置き換えます。0x000000を指定しても変更はありません。

en: replace white with this value. Specifying 0xFFFFFF makes no changes.
ja: 白をこの値で置き換えます。0xFFFFFFを指定しても変更はありません。

en: Examples:
ja: 例：

en: `tint_with(0x000000, 0xFFFFFF)` is a no-op.
ja: `tint_with(0x000000, 0xFFFFFF)` は操作なしです。

en: `tint_with(0x00FF00, 0xFFFFFF)` changes black to green, leaves white intact.
ja: `tint_with(0x00FF00, 0xFFFFFF)` は黒を緑に変更し、白はそのままです。

en: `tint_with(0xFF0000, 0x0000FF)` changes black to red and white to blue.
ja: `tint_with(0xFF0000, 0x0000FF)` は黒を赤に変更し、白を青に変更します。

en: Apply a gamma factor to a pixmap, i.e. lighten or darken it. Pixmaps with colorspace *None* are ignored with a warning.
ja: ピクセルマップにガンマ係数を適用し、つまり明るくしたり暗くしたりします。色空間が *None* のピクセルマップは警告とともに無視されます。

en: *gamma = 1.0* does nothing, *gamma < 1.0* lightens, *gamma > 1.0* darkens the image.
ja: *gamma = 1.0* は何も行いません。*gamma < 1.0* は明るくし、*gamma > 1.0* は暗くします。

en: Shrink the pixmap by dividing both, its width and height by 2\ :sup:`n`.
ja: Pixmapを2の :sup:`n` 乗で縮小します。

en: 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.
ja: 新しいPixmap（サンプル）のサイズを決定します。例えば、値が2の場合、幅と高さを4分の1に分割し、元のサイズの16分の1のサイズになります。1未満の値は警告として無視されます。

en: 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.
ja: これを使用して比を保持したままPixmapのサイズを縮小します。Pixmapは「その場で」変更されます。元のピクセルを保持し、より詳細な選択肢を持つ場合は、上記のコピーコンストラクタを使用してください。

en: *New in version:: 1.14.5:* Return the value of the pixel at location (x, y) (column, line).
ja: *バージョン1.14.5* で新規追加：位置（x、y）（列、行）のピクセルの値を返します。

en: the column number of the pixel. Must be in `range(pix.width)`.
ja: ピクセルの列番号。範囲 `range(pix.width)` 内である必要があります。

en: the line number of the pixel, Must be in `range(pix.height)`.
ja: ピクセルの行番号、範囲 `range(pix.height)` 内である必要があります。

en: 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)`.
ja: 色の値と、必要に応じてアルファ値のリスト。その長さと内容は、Pixmap の色空間とアルファの存在に依存します。RGBAピクセルマップの場合、結果は例えば *[r、g、b、a]* となります。すべてのアイテムは `range(256)` の整数です。

en: *New in version 1.14.7:* Manipulate the pixel at location (x, y) (column, line).
ja: *バージョン1.14.7で新規追加：* 位置（x、y）（列、行）のピクセルを操作します。

en: the line number of the pixel. Must be in `range(pix.height)`.
ja: ピクセルの行番号、`range(pix.height)` 内である必要があります。

en: 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.
ja: `range(256)` の整数で表されるシーケンスとして指定された所望のピクセル値。シーケンスの長さは :attr:`Pixmap.n` に等しくなければならず、これにはアルファバイトも含まれます。

en: *New in version 1.14.8:* Set the pixels of a rectangle to a value.
ja: *新しいバージョン1.14.8で導入されました：* 特定の値で長方形のピクセルを設定します。

en: 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.
ja: 値で埋める長方形。実際のエリアはこのパラメータと :attr:`Pixmap.irect`  の交差です。空の交差（または無効なパラメータ）の場合、変更は行われません。

en: 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.
ja: `range(256)` 内の整数のシーケンスとして指定された所望の値。シーケンスの長さは :attr:`Pixmap.n` と等しくなければならず、これにはアルファバイトも含まれます。

en: *False* if the rectangle was invalid or had an empty intersection with :attr:`Pixmap.irect`, else *True*.
ja: irectが無効であるか、:attr:`Pixmap.irect` と交差しない場合は *False*、それ以外の場合は *True* 。

en: 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.
ja: このメソッドは、多くのピクセルが関与する場合に **非常に高速** であるため、長方形内の各ピクセルに対して実行される :meth:`Pixmap.set_pixel` と同等です。

en: 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).
ja: このメソッドは、:meth:`Pixmap.clear_with` のように、次のようにして特定の色でピクセルマップを初期化するために使用できます。 *pix.set_rect(pix.irect, (255, 255, 0))* （RGBの例、ピクセルマップ全体を黄色で色付けします）。

en: New in v1.17.7
ja: v1.17.7で新規導入

en: Set the x and y values of the pixmap's top-left point.
ja: ピクセルマップの左上の点のxとyの値を設定します。

en: x coordinate
ja: x座標

en: y coordinate
ja: y座標

en: New in v1.16.17
ja: v1.16.17で新規導入.

en: Changed in v1.18.0: When saving as a PNG image, these values will be stored now.
ja: v1.18.0で変更：PNGイメージとして保存する場合、これらの値が保存されるようになりました。

en: Set the resolution (dpi) in x and y direction.
ja: xおよびy方向の解像度（dpi）を設定します。

en: resolution in x direction.
ja: x方向の解像度。

en: resolution in y direction.
ja: y方向の解像度。

en: Changed in v 1.18.13
ja: 変更内容：v1.18.13で変更

en: Change the alpha values. The pixmap must have an alpha channel.
ja: アルファ値を変更します。ピクマップにはアルファチャンネルが必要です。

en: 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.
ja: 新しいアルファ値。指定された場合、その長さは少なくとも *幅×高* さでなければなりません。省略した場合（`None`）、すべてのアルファ値が255（透明でない）に設定されます。*バージョン1.14.13で変更：* *io.BytesIO* も受け入れられるようになりました。

en: *New in v1.18.13:* whether to premultiply color components with the alpha value.
ja: *v1.18.13で新登場：* カラーコンポーネントをアルファ値と乗算するかどうか。

en: 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).
ja: アルファ値を無視し、この色を完全に透明に設定します。長さが :attr:`Pixmap.n` で `range(256)` 内の整数のシーケンスです。デフォルトは *None* です。たとえば、RGBの典型的な選択肢は `opaque=(255, 255, 255)` （白）です。

en: Invert the color of all pixels in :ref:`IRect` *irect*. Will have no effect if colorspace is *None*.
ja: :ref:`IRect` *irect* 内のすべてのピクセルの色を反転させます。colorspaceが *None* の場合は効果がありません。

en: The area to be inverted. Omit to invert everything.
ja: 反転する領域。すべて反転するには省略します。

en: 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:
ja: *ソース* ピクマップの *irect* 部分を、このピクマップの対応する領域にコピーします。2つのピクマップは異なる寸法を持つことができ、それぞれが :data:`CS_GRAY` または :data:`CS_RGB` カラースペースを持つことができますが、現在は同じアルファプロパティ [#f2]_ を持っている必要があります。コピー機構は、次のようにソースとターゲットの間の不一致を自動的に調整します。

en: 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.
ja: :data:`CS_GRAY` から :data:`CS_RGB` にコピーする場合、ソースのグレーシェード値は、3つのRGBコンポーネントバイトの各々に配置されます。逆の場合、*（r + g + b）/ 3* がターゲットのグレーシェード値として取られます。

en: 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.
ja: *irect* とターゲットピクマップの長方形の間で、まず「交差」を計算します。これは、長方形の座標と現在の属性値 :attr:`Pixmap.x` および  :attr:`Pixmap.y` （これを目的のために :meth:`Pixmap.set_origin` を介して自由に変更できます）を考慮に入れます。その後、この交差のデータがコピーされます。交差が空の場合、何も起こりません。

en: The area to be copied.
ja: コピーする領域。

en: 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::
ja: 例： `pix1` と `pix2` という2つのピクマップがあるとし、`pix2` の右下の四半期を `pix1` にコピーし、それが `pix1` の左上の点から開始するようにしたい場合、次のスニペットを使用します::

en: Changed in v1.22.0: Added **direct support of JPEG** images. Image quality can be controlled via parameter "jpg_quality".
ja: v1.22.0で変更：**JPEG画像の直接サポート** が追加されました。画像の品質は「jpg_quality」パラメータを使用して制御できます。

en: 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.
ja: Pixmapを画像ファイルとして保存します。選択した出力に応じて、一部またはすべてのカラースペースがサポートされ、異なるファイル拡張子を選択できます。詳細については以下の表をご覧ください。

en: 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.
ja: 保存先のファイル。文字列、``pathlib.Path`` 、またはPythonファイルオブジェクトとして提供できます。後の2つの場合、ファイル名は対応するオブジェクトから取得されます。ファイル名の拡張子は画像フォーマットを決定し、出力パラメータで上書きできます。

en: 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`.
ja: 望ましい画像フォーマット。デフォルトはファイル名の拡張子です。この値とファイル拡張子の両方がサポートされていない場合、例外が発生します。:ref:`PixmapOutput` を参照してください。

en: 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.
ja: 望ましい画像品質、デフォルトは95です。JPEG画像にのみ適用され、それ以外の場合は無視されます。このパラメータは品質とファイルサイズをトレードオフにします。値が98の場合、ほぼロスレスです。より高い値は品質を向上させることはありません。

en: Raises
ja: 例外

en: For unsupported image formats.
ja: サポートされていない画像フォーマットの場合。

en: New in version 1.14.5: Return the pixmap as a *bytes* memory object of the specified format -- similar to :meth:`save`.
ja: 新機能（バージョン1.14.5）：指定されたフォーマットのピクマップをバイトメモリオブジェクトとして返します。これは :meth:`save` と似ています。

en: Changed in v1.22.0: Added **direct JPEG support**. Image quality can be influenced via new parameter "jpg_quality".
ja: v1.22.0で変更： **JPEG画像の直接サポート** が追加されました。画像の品質は「jpg_quality」パラメータを使用して制御できます。

en: The desired image format. The default is "png". For possible values see :ref:`PixmapOutput`.
ja: 望ましい画像フォーマット。デフォルトは "png" です。:ref:`PixmapOutput` を参照してください。

en: The requested image format. The default is "png". For other possible values see :ref:`PixmapOutput`.
ja: リクエストされた画像フォーマットです。デフォルトは "png" です。:ref:`PixmapOutput` を参照してください。

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

en: Changed in v1.22.5: Support of new parameter for Tesseract's tessdata.
ja: v1.22.5 で変更：Tesseract の tessdata に関する新しいパラメータのサポート。

en: Perform text recognition using Tesseract and save the image as a 1-page PDF with an OCR text layer.
ja: Tesseract を使用してテキスト認識を実行し、OCR テキスト レイヤーを持つ 1 ページの PDF として画像を保存します。

en: identifies the file to save to. May be either a string or a pointer to a file opened with "wb" (includes `io.BytesIO()` objects).
ja: 保存先のファイルを識別します。文字列または "wb" で開かれたファイルへのポインタ (`io.BytesIO()` オブジェクトを含む）のいずれかである必要があります。

en: whether to compress the resulting PDF, default is `True`.
ja: 結果の PDF を圧縮するかどうか。デフォルトは `True` です。

en: 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.
ja: 画像内で使用される言語。Tesseract の形式で指定する必要があります。デフォルトは "eng"（英語）です。複数の言語を使用する場合、"eng+spa" のように "+" で区切った Tesseract 言語コードを使用します（英語とスペイン語の場合など）。

en: : arg str tessdata: folder name of Tesseract's language support. If omitted, this information must be present as environment variable `TESSDATA_PREFIX`.
ja: :arg str tessdata: Tesseractの言語サポートフォルダーの名前です。省略した場合、この情報は環境変数 `TESSDATA_PREFIX` として存在している必要があります。

en: **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.
ja: Tesseract がインストールされていない場合や、環境変数 "TESSDATA_PREFIX" が `tessdata` フォルダ名に設定されておらず、またはパラメータとして提供されていない場合、この関数は **失敗します** 。

en: 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]`.
ja: メモリ内の1ページのPDFファイル。次のようにして開くことができます： `doc=fitz.open("pdf", pix.pdfocr_tobytes())` 、そしてそのページ=doc[0]でテキストの抽出が行えます。

en: 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::
ja: 別の可能性として、PDF に挿入することが考えられます。次のスニペットは、フォルダ内の画像を読み取り、OCR テキスト レイヤーを含む新しい PDF ページとして保存します::

en: New in v1.17.3
ja: v1.17.3 で新しく追加されました

en: Write the pixmap as an image file using Pillow. Use this method for output unsupported by MuPDF. Examples are
ja: Pillow を使用して pixmap を画像ファイルとして書き込みます。これは MuPDF でサポートされていない出力に使用します。例として、以下が挙げられます。

en: Formats JPX, J2K, WebP, etc.
ja: JPX、J2K、WebP などの形式

en: Storing EXIF information.
ja: EXIF 情報の保存

en: If you do not provide dpi information, the values *xres*, *yres* stored with the pixmap are automatically used.
ja: dpi 情報を提供しない場合、pixmap に格納されている *xres*、*yres* の値が自動的に使用されます。

en: A simple example: `pix.pil_save("some.webp", optimize=True, dpi=(150, 150))`. For details on other parameters see the Pillow documentation.
ja: 簡単な例: `pix.pil_save("some.webp", optimize=True, dpi=(150, 150))` 。他のパラメータの詳細については、Pillow のドキュメンテーションを参照してください。

en: 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.
ja: v1.22.0 以降、PyMuPDF はJPEG 出力を直接サポートしています。パフォーマンスの理由と外部の依存関係を減らすために、JPEG 画像を出力する場合にはこのメソッドの使用は推奨されなくなりました。

en: if Pillow is not installed.
ja: Pillow がインストールされていない場合

en: .raises ImportError: if Pillow is not installed.
ja: **ImportError** -- Pillow がインストールされていない場合

en: New in v1.19.3
ja: v1.19.3 で新しく追加されました

en: 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)`.
ja: 四角形を "ワープ" して、四角形の角が新しい pixmap の角になるようにします。対象 pixmap の `irect` は `(0, 0, width, height)` になります。

en: a convex quad with coordinates inside :attr:`Pixmap.irect` (including the border points).
ja: :attr:`Pixmap.irect` の内部にある座標を持つ凸四角形（境界点も含む）

en: desired resulting width.
ja: 望ましい幅

en: desired resulting height.
ja: 望ましい高さ

en: 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.
ja: 新しいピクスマップで、四角形の角が時計回りにピクスマップの角にマップされます: `quad.ul -> irect.tl`、`quad.ur -> irect.tr` など。

en: New in v1.19.2
ja: v1.19.2で導入

en: Changed in v1.19.3
ja: v1.19.3で変更

en: Determine the pixmap's unique colors and their count.
ja: Pixmapのユニークな色とそのカウントを特定します。

en: *(changed in v1.19.3)* If `True` return a dictionary of color pixels and their usage count, else just the number of unique colors.
ja: *（v1.19.3で変更）* `True` の場合、色ピクセルとその使用回数の辞書を返し、それ以外の場合はユニークな色の数だけを返します。

en: 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.
ja: :attr:`Pixmap.irect` 内の四角形。指定した場合、そのピクセルのみが考慮されます。これにより、指定されたPixmapのサブ四角形を直接調査できます。

en: 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`.
ja: 色の数、または `pixel: count` の項目を持つ辞書。pixelキーは :attr:`Pixmap.n` の長さの `bytes` オブジェクトです。

en: To recover the **tuple** of a pixel, use `tuple(colors.keys()[i])` for the i-th item.
ja: ピクセルのタプルを復元するには、i番目の項目に対して `tuple(colors.keys()[i])` を使用します。

en: The response time depends on the pixmap's samples size and may be more than a second for very large pixmaps.
ja: 応答時間はPixmapのsamplesサイズに依存し、非常に大きなPixmapの場合は1秒以上かかることがあります。

en: Where applicable, pixels with different alpha values will be treated as different colors.
ja: 該当する場合、異なるアルファ値を持つピクセルは異なる色として扱われます。

en: Return the most frequently used color and its relative frequency.
ja: 最も頻繁に使用される色とその相対頻度を返します。

en: 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.
ja: :attr:`Pixmap.irect` 内の四角形。指定した場合、そのピクセルのみが考慮されます。これにより、指定されたPixmapのサブ四角形を直接調査できます。

en: 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`.
ja: 比率 `0 < ratio <= 1` および色のピクセル値を持つタプル。これを使用して画像が「ほぼ」単一の色であるかどうかを判断します。応答 `(0.95, b"\x00\x00\x00")` は、すべてのピクセルの95%が黒であることを示します。こちらの例を参照してください：「Pixmapsの使用方法：テキストの可視性の確認」

en: Indicates whether the pixmap contains transparency information.
ja: Pixmapに透明情報が含まれているかどうかを示します。

en: The MD5 hashcode (16 bytes) of the pixmap. This is a technical value used for unique identifications.
ja: PixmapのMD5ハッシュコード（16バイト）。これは一意の識別に使用される技術的な値です。

en: 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).
ja: Pixmapのカラースペース。この値は、イメージが *イメージマスク* または *ステンシルマスク* として扱われる場合、*None* になることがあります（現在、抽出されたPDFドキュメントイメージのみが該当）。

en: 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:
ja: :attr:`Pixmap.samples` 内の画像データの1行の長さを含みます。これは主に計算目的で使用されます。次の式が真です：

en: Is `True` for a gray pixmap which only has the colors black and white.
ja: 灰色のピクマップで、黒と白の色しか持たない場合は `True` です。

en: Is `True` if all pixels are identical (any colorspace). Where applicable, pixels with different alpha values will be treated as different colors.
ja: すべてのピクセルが同じ場合、`True` です（どのカラースペースでも適用）。該当する場合、異なるアルファ値を持つピクセルは異なる色として扱われます。

en: Contains the :ref:`IRect` of the pixmap.
ja: ピクマップの :ref:`IRect` を含みます。

en: 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.
ja: すべてのピクセルの色と（ :attr:`Pixmap.alpha` がtrueの場合）透明度の値です。これは `width * height * n` バイトの領域です。各nバイトは1つのピクセルを定義します。各続くnバイトは、スキャンラインの順序で別のピクセルを生成します。連続するスキャンラインはパディングなしで続きます。たとえばRGBAカラースペースの場合、*samples* は *…、R、G、B、A、…* のようなバイトのシーケンスで、4つのバイト値R、G、B、Aが1つのピクセルを定義します。

en: 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.
ja: この領域は、PIL（Python Imaging Library）などの他のグラフィックライブラリに渡すことができ、ピクマップを他の画像形式で保存するなどの追加の処理を行うのに使用できます。

en: 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).
ja: 基本データは通常、この属性にアクセスするたびに `bytes` のコピーが作成される大きなメモリ領域です。たとえば、RGBAでレンダリングされた文字ページのsamplesサイズはほぼ1.4 MBです。したがって、新しい変数に代入するか、`memoryview` バージョン :attr:`Pixmap.samples_mv` （v1.18.17で新機能）を使用するか、などの検討が必要です。

en: Any changes to the underlying data are available only after accessing this attribute again. This is different from using the memoryview version.
ja: 基本データへの変更は、この属性に再度アクセスするまで利用できません。これは `memoryview` バージョンを使用する場合とは異なります。

en: New in v1.18.17
ja: 新機能 v1.18.17

en: 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.
ja: :attr:`Pixmap.samples` と同様ですが、Pythonの `memoryview` 形式です。これはピクマップ内のメモリを指すように構築されており、コピーではありません。そのため、作成速度はピクマップのサイズに依存せず、ピクセルへの変更はすぐに利用可能です。

en: Copies like `bytearray(pix.samples_mv)`, or `bytes(pixmap.samples_mv)` are equivalent to and can be used in place of `pix.samples`.
ja: `bytearray(pix.samples_mv)` や `bytes(pixmap.samples_mv)` などのコピーは、`pix.samples` の代わりに使用でき、同等です。

en: We also have `len(pix.samples) == len(pix.samples_mv)`.
ja: また、`len(pix.samples) == len(pix.samples_mv)` です。

en: Look at this example from a 2 MB JPEG: the memoryview is **ten thousand times faster**::
ja: この2 MBのJPEGからのこの例をご覧ください： `memoryview` は **10000倍高速** です::

en: 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::
ja: ピクセル領域へのPythonポインターです。これは特別な整数形式で、サポートするアプリケーション（PyQtなど）がサンプル領域に直接アクセスし、非常に高速に画像を構築できるように使用できます。例えば::

en: 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.
ja: 以下はQtイメージへの2つの方法ですが、(2)はピクセル領域の追加のコピーを回避するため、通常 **何百倍も高速** です。

en: Contains *len(pixmap)*. This will generally equal *len(pix.samples)* plus some platform-specific value for defining other attributes of the object.
ja: これは *pixmap の長さ* を含んでいます。通常、これは *pix.samples の長さ* にプラットフォーム固有の他の属性を定義するためのいくつかの値を加えたものです。

en: Width of the region in pixels.
ja: ピクセル単位の領域の幅。

en: Height of the region in pixels.
ja: ピクセル単位の領域の高さ。

en: X-coordinate of top-left corner in pixels. Cannot directly be changed -- use :meth:`Pixmap.set_origin`.
ja: ピクセル単位での左上隅のX座標。直接変更できません。:meth:`Pixmap.set_origin` を使用してください。

en: Y-coordinate of top-left corner in pixels. Cannot directly be changed -- use :meth:`Pixmap.set_origin`.
ja: ピクセル単位での左上隅のY座標。直接変更できません。:meth:`Pixmap.set_origin` を使用してください。

en: 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*.
ja: ピクセルごとのコンポーネントの数。この数は色空間とアルファに依存します。色空間が *None* でない場合（ステンシルマスク）、*Pixmap.n - Pixmap.alpha == pixmap.colorspace.n* がtrueです。色空間が *None* の場合、*n == alpha == 1* です。

en: Horizontal resolution in dpi (dots per inch). Please also see :data:`resolution`. Cannot directly be changed -- use :meth:`Pixmap.set_dpi`.
ja: 水平解像度（dpi単位）。:data:`resolution` も参照してください。直接変更できません。:meth:`Pixmap.set_dpi` を使用してください。

en: Vertical resolution in dpi (dots per inch). Please also see :data:`resolution`. Cannot directly be changed -- use :meth:`Pixmap.set_dpi`.
ja: 垂直解像度（dpi単位）。:data:`resolution` も参照してください。直接変更できません。:meth:`Pixmap.set_dpi` を使用してください。

en: 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.
ja: 情報のみのブールフラグで、イメージが「線形補間」を使用して描画される場合に *True* に設定されます。*False* の場合、「最近傍サンプリング」が使用されます。

en: Supported Input Image Formats
ja: サポートされている入力画像フォーマット

en: 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:
ja: 次のファイルタイプは、ピクスマップを構築するための **入力** としてサポートされています：**BMP、JPEG、GIF、TIFF、JXR、JPX**、**PNG**、**PAM**、およびすべての **Portable Anymap** ファミリー（**PBM、PGM、PNM、PPM**）。このサポートは二重の方法で提供されています：

en: Directly create a pixmap with *Pixmap(filename)* or *Pixmap(byterray)*. The pixmap will then have properties as determined by the image.
ja: *Pixmap（ファイル名）* または *Pixmap（バイト配列）* を使用してピクスマップを直接作成します。その後、ピクスマップには画像によって決定されるプロパティが含まれます。

en: 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.
ja: *fitz.open(...)* を使用してこのようなファイルを開きます。その結果、単一のページを含むドキュメントとして表示されます。このページのピクスマップを作成すると、このコンテキストで利用可能なすべてのオプションを使用できます：行列を適用、色空間とアルファを選択、ピクスマップをクリップエリアに制限などが含まれます。

en: **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]_.
ja: **SVG画像** は、直接ピクスマップとしてではなく、上記の方法2でのみサポートされています。ただし、ピクスマップの場合と同様、その結果は **ラスターイメージ** です [#f1]_。

en: Supported Output Image Formats
ja: サポートされている出力画像フォーマット

en: 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.
ja: いくつかの画像 **出力** フォーマットがサポートされています。画像を直接ファイルに書き込むオプション（:meth:`Pixmap.save`）またはバイトオブジェクトを生成するオプション（:meth:`Pixmap.tobytes`）があります。どちらのメソッドも、希望の **フォーマット** を識別する文字列を受け入れます（下のフォーマット列）。ただし、すべてのピクスマップの色空間、透明度サポート（アルファ）、および画像フォーマットの組み合わせが可能であるわけではないことに注意してください。

en: **Format**
ja: **フォーマット**

en: **Colorspaces**
ja: **カラースペース**

en: **alpha**
ja: **アルファ**

en: **Extensions**
ja: **拡張子**

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

en: no
ja: なし

en: yes
ja: あり

en: 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.
ja: すべての画像ファイル形式がすべてのOSプラットフォームでサポートされているわけではありません（または少なくとも一般的ではありません）。たとえば、PAMおよびPortable Anymap形式はWindowsでは珍しいか、またはまったく知られていません。

en: 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.
ja: 特にCMYKカラースペースに関連することについて、常にCMYK pixmapを *rgb_pix = fitz.Pixmap(fitz.csRGB、cmyk_pix)* に変換し、その後、その形式で保存できます。

en: 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.
ja: ご覧のように、MuPDFの画像サポート範囲は入力と出力で異なります。両方の方法でサポートされているものの中で、PNGとJPEGはおそらく最も人気があります。

en: 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).
ja: また、tkinterの *PhotoImage* メソッドへの入力として「ppm」形式を使用することをお勧めします。*tkimg = tkinter.PhotoImage(data=pix.tobytes("ppm"))* のように（チュートリアルも参照してください）。これは **非常に** 高速です（PNGよりも60倍速いです）。

en: Footnotes
ja: 脚注

en: 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 <https://pypi.org/project/svglib>`_, `CairoSVG <https://pypi.org/project/cairosvg>`_, `Uniconvertor <https://sk1project.net/modules.php?name=Products&product=uniconvertor&op=download>`_ or the Java solution `Apache Batik <https://github.com/apache/batik>`_. Have a look at our Wiki for more examples.
ja: SVGから **ベクトル画像** が必要な場合、まずそれをPDFに変換する必要があります。:meth:`Document.convert_to_pdf` を試してみてください。これで十分でない場合、他のSVGからPDFへの変換ツールを探してみてください。Pythonパッケージ `svglib <https://pypi.org/project/svglib>`_ 、 `CairoSVG <https://pypi.org/project/cairosvg>`_ 、 `Uniconvertor <https://sk1project.net/modules.php?name=Products&product=uniconvertor&op=download>`_ 、またはJavaソリューションである `Apache Batik <https://github.com/apache/batik>`_ などがあります。詳細な例についてはWikiをご覧ください。

en: To also set the alpha property, add an additional step to this method by dropping or adding an alpha channel to the result.
ja: アルファプロパティも設定する場合は、このメソッドに追加ステップを追加し、結果にアルファチャンネルを追加または削除してください。
