backend_pdf#

PDF Matplotlib バックエンド。

著者: Jouni K Seppänen < jks @ iki . fi > など。

matplotlib.backends.backend_pdf. FigureCanvas [ソース] #

のエイリアスFigureCanvasPdf

クラス matplotlib.backends.backend_pdf. FigureCanvasPdf (=なし) [ソース] #

拠点:FigureCanvasBase

draw ( ) [ソース] #

をレンダリングしFigureます。

このメソッドは、出力が生成されない場合でも、アーティスト ツリーをたどる必要があります。これは、ユーザーが出力をディスクに保存する前にアクセスする可能性がある遅延作業をトリガーするためです。たとえば、制限、自動制限、目盛り値の計算などです。

filetypes = {'pdf': 'Portable Document Format'} #
fixed_dpi = 72 #
get_default_filetype ( ) [ソース] #

で指定されたデフォルトの savefig ファイル形式を返します rcParams["savefig.format"](デフォルト: 'png')。

返された文字列にはピリオドが含まれていません。このメソッドは、単一のファイル タイプのみをサポートするバックエンドでオーバーライドされます。

print_pdf (ファイル名, * , bbox_inches_restore =なし,メタデータ=なし) [ソース] #
クラス matplotlib.backends.backend_pdf. GraphicsContextPdf (ファイル) [ソース] #

拠点:GraphicsContextBase

alpha_cmd ( alpha , forced , effective_alphas ) [ソース] #
capstyle_cmd (スタイル) [ソース] #
capstyles = {'butt': 0, 'projecting': 2, 'round': 1} #
clip_cmd ( cliprect , clippath ) [ソース] #

クリップ長方形を設定します。と. pop()_push()

コマンド= ((('_cliprect', '_clippath'), <function GraphicsContextPdf.clip_cmd>), (('_alpha', '_forced_alpha', '_effective_alphas'), <function GraphicsContextPdf.alpha_cmd>), (('_capstyle' ,), <function GraphicsContextPdf.capstyle_cmd>), (('_fillcolor',), <function GraphicsContextPdf.fillcolor_cmd>), (('_joinstyle',), <function GraphicsContextPdf.joinstyle_cmd>), (('_linewidth',) , <function GraphicsContextPdf.linewidth_cmd>), (('_dashes',), <function GraphicsContextPdf.dash_cmd>), (('_rgb',), <関数 GraphicsContextPdf.rgb_cmd>), (('_hatch', '_hatch_color'), <function GraphicsContextPdf.hatch_cmd>)) #
copy_properties (その他) [ソース] #

other のプロパティを自分にコピーします。

dash_cmd (ダッシュ) [ソース] #
デルタ(その他) [ソース] #

other のプロパティを self にコピーし、self を other に変換するために必要な PDF コマンドを返します。

fill ( * args ) [ソース] #

述語: パスを埋める必要がありますか?

RendererPdf.draw_markers の必要に応じて、オプションの引数を使用して代替の _fillcolor を指定できます。

fillcolor_cmd ( rgb ) [ソース] #
ファイナライズ( ) [ソース] #

プッシュされたすべてのグラフィックス状態がポップされていることを確認してください。

ハッチ_cmd (ハッチ,ハッチカラー) [ソース] #
joinstyle_cmd (スタイル) [ソース] #
joinstyles = {'bevel': 2, 'miter': 0, 'round': 1} #
linewidth_cmd () [ソース] #
ペイント( ) [ソース] #

適切な pdf 演算子を返し、パスをストローク、塗りつぶし、またはその両方にします。

pop ( ) [ソース] #
プッシュ( ) [ソース] #
rgb_cmd ( rgb ) [ソース] #
ストローク( ) [ソース] #

述語: パスをストロークする (輪郭を描く) 必要がありますか? これは、パスのストロークを無効にするさまざまな条件をテストします。その場合、パスはおそらく塗りつぶされます。

クラス matplotlib.backends.backend_pdf. 名前(名前) [出典] #

拠点:object

PDF 名オブジェクト。

static hexify ( match ) [source] #

[非推奨]

ノート

バージョン 3.6 以降非推奨:

名前#
pdfRepr ( ) [ソース] #
クラス matplotlib.backends.backend_pdf. Op () [ソース] #

拠点:Enum

PDF 演算子 (完全なリストではありません)。

begin_text = b'BT' [ソース] #
クリップ= b'W' [ソース] #
close_fill_stroke = b'b' [ソース] #
close_stroke = b's' [ソース] #
closepath = b'h' [ソース] #
concat_matrix = b'cm' [ソース] #
Curveto = b'c' [ソース] #
end_text = b'ET' [ソース] #
endpath = b'n' [ソース] #
fill = b'f' [ソース] #
fill_stroke = b'B' [ソース] #
grestore = b'Q' [ソース] #
gsave = b'q' [ソース] #
lineto = b'l' [ソース] #
moveto = b'm' [ソース] #
プロパティ op [ソース] #
classmethod paint_path ( fill , stroke ) [ソース] #

パスをペイントする PDF オペレーターを返します。

パラメータ:
ブールを埋める

塗りつぶしの色でパスを塗りつぶします。

ストロークブール

パスの輪郭を線の色でなぞります。

pdfRepr ( ) [ソース] #
四角形= b're' [ソース] #
selectfont = b'Tf' [ソース] #
setcolor_nonstroke = b'scn' [ソース] #
setcolor_stroke = b'SCN' [ソース] #
setcolorspace_nonstroke = b'cs' [ソース] #
setcolorspace_stroke = b'CS' [ソース] #
setdash = b'd' [ソース] #
setgray_nonstroke = b'g' [ソース] #
setgray_stroke = b'G' [ソース] #
setgstate = b'gs' [ソース] #
setlinecap = b'J' [ソース] #
setlinejoin = b'j' [ソース] #
setlinewidth = b'w' [ソース] #
setrgb_nonstroke = b'rg' [ソース] #
setrgb_stroke = b'RG' [ソース] #
shading = b'sh' [ソース] #
show = b'Tj' [ソース] #
showkern = b'TJ' [ソース] #
ストローク= b'S' [ソース] #
textmatrix = b'Tm' [ソース] #
textpos = b'Td' [ソース] #
use_xobject = b'Do' [ソース] #
クラス matplotlib.backends.backend_pdf. 演算子( op ) [ソース] #

拠点:object

[非推奨]

ノート

バージョン 3.6 以降非推奨:

操作番号
pdfRepr ( ) [ソース] #
クラス matplotlib.backends.backend_pdf. PdfFile (ファイル名メタデータ=なし) [ソース] #

拠点:object

PDF ファイル オブジェクト。

パラメータ:
filename str または path-like または file-like

出力ターゲット。文字列の場合、書き込み用にファイルが開かれます。

文字列から文字列と日付へのメタデータdict

情報ディクショナリ オブジェクト (PDF リファレンス セクション 10.2.1「ドキュメント情報ディクショナリ」を参照) 。{'Creator': 'My software', 'Author': 'Me', 'Title': 'Awesome'}

標準キーは、'Title'、'Author'、'Subject'、'Keywords'、'Creator'、'Producer'、'CreationDate'、'ModDate'、'Trapped' です。「Creator」、「Producer」、および「CreationDate」の値は事前定義されています。に設定することで削除できますNone

addGouraudTriangles (ポイント,) [ソース] #

グーロー三角形のシェーディングを追加します。

パラメータ:
ポイントnp.ndarray

三角形の頂点、形状 (n, 3, 2) (n = 三角形の数、3 = 頂点、2 = x、y)。

np.ndarray

頂点の色、形状はポイントと同様に (n, 3, 1) または (n, 3, 4) ですが、最後の次元は (gray,) または (r, g, b, alpha) のいずれかです。

戻り値:
名前、参照
alphaState (アルファ) [ソース] #

アルファを指定された値に設定する ExtGState の名前を返します。

beginStream ( id , len , extra =なし, png =なし) [source] #
閉じる( ) [ソース] #

すべてのバッファをフラッシュし、すべてのリソースを解放します。

createType1Descriptor ( t1font , fontfile ) [ソース] #
dviFontName ( dvifont ) [ソース] #

dvi フォント オブジェクトを指定すると、Op.selectfont に適した名前を返します。フォント情報が登録されself.dviFontInfoていない場合は登録します。

embedTTF (ファイル名,文字) [ソース] #

指定されたファイルからドキュメントに TTF フォントを埋め込みます。

endStream ( ) [ソース] #
ファイナライズ( ) [ソース] #

さまざまな遅延オブジェクトと pdf 最終事項を書き出します。

fontName ( fontprop ) [ソース] #

fontprop に基づいてフォントを選択し、Op.selectfont に適した名前を返します。fontprop が文字列の場合、フォントのファイル名として解釈されます。

ハッチパターン( hatch_style ) [ソース] #
imageObject (画像) [ソース] #

指定された画像を表す画像 XObject の名前を返します。

markerObject ( path , trans , fill , stroke , lw , joinstyle , capstyle ) [source] #

指定されたパスを表すマーカー XObject の名前を返します。

newPage (高さ) [ソース] #
newTextnote ( text , positionRect = [-100, -100, 0, 0] ) [ソース] #
出力( *データ) [ソース] #
outputStream ( ref , data , * , extra = None ) [source] #
pathCollectionObject ( gc , path , trans ,パディング,塗りつぶし,ストローク) [ソース] #
static pathOperations ( path , transform , clip = None , simple = None , sketch = None ) [source] #
recordXref ( id ) [ソース] #
reserveObject ( name = '' ) [ソース] #

間接オブジェクトの ID を予約します。

この名前は、writeObject でオブジェクトを出力するのを忘れた場合のデバッグに使用されます。

書き込み(データ) [ソース] #
writeExtGSTates ( ) [ソース] #
writeFonts ( ) [ソース] #
writeGouraudTriangles ( ) [ソース] #
writeHatches ( ) [ソース] #
writeImages ( ) [ソース] #
writeInfoDict ( ) [ソース] #

情報辞書を書き出し、適切な形式かどうかを確認します

writeMarkers ( ) [ソース] #
writeObject (オブジェクト,内容) [ソース] #
writePath ( path , transform , clip = False , sketch = None ) [source] #
writePathCollectionTemplates ( ) [ソース] #
writeTrailer ( ) [ソース] #

PDF トレーラーを書き出します。

writeXref ( ) [ソース] #

外部参照テーブルを書き出します。

クラス matplotlib.backends.backend_pdf. PdfPages ( filename , keep_empty = True , metadata = None ) [source] #

拠点:object

複数ページの PDF ファイル。

ノート

実際には、 format 引数を使用したり忘れたりするときの混乱を避けるために、PdfPagesの薄いラッパーです。PdfFilesavefig

>>> import matplotlib.pyplot as plt
>>> # Initialize:
>>> with PdfPages('foo.pdf') as pdf:
...     # As many times as you like, create a figure fig and save it:
...     fig = plt.figure()
...     pdf.savefig(fig)
...     # When no figure is specified the current figure is saved
...     pdf.savefig()

新しい PdfPages オブジェクトを作成します。

パラメータ:
filename str または path-like または file-like

を使用したプロットPdfPages.savefigは、この場所のファイルに書き込まれます。ファイルはすぐに開かれ、同じ名前の古いファイルは上書きされます。

keep_emptyブール値、オプション

False に設定すると、空の PDF ファイルは閉じるときに自動的に削除されます。

メタデータ辞書、オプション

情報ディクショナリ オブジェクト (PDF リファレンス セクション 10.2.1「ドキュメント情報ディクショナリ」を参照) 。{'Creator': 'My software', 'Author': 'Me', 'Title': 'Awesome'}

標準キーは、'Title'、'Author'、'Subject'、'Keywords'、'Creator'、'Producer'、'CreationDate'、'ModDate'、'Trapped' です。「Creator」、「Producer」、および「CreationDate」の値は事前定義されています。に設定することで削除できますNone

attach_note ( text , positionRect = [-100, -100, 0, 0] ) [ソース] #

次に保存するページに新しいテキスト ノートを追加します。オプションの positionRect は、ページ上の新しいメモの位置を指定します。印刷時に見えないようにするために、デフォルトではページの外側にあります。

閉じる( ) [ソース] #

このオブジェクトをファイナライズして、基になるファイルを完全な PDF ファイルにします。

get_pagecount ( ) [ソース] #

複数ページの pdf ファイルの現在のページ数を返します。

infodict ( ) [ソース] #

変更可能な情報ディクショナリ オブジェクトを返します (PDF リファレンス セクション 10.2.1「ドキュメント情報ディクショナリ」を参照)。

keep_empty #
savefig ( figure = None , ** kwargs ) [source] #

Figureこのファイルに新しいページとして保存します。

その他のキーワード引数は に渡されsavefigます。

パラメータ:
figureFigureまたは int、デフォルト: アクティブな Figure

ファイルに保存される Figure または Figure のインデックス。

クラス matplotlib.backends.backend_pdf. 参照( id ) [ソース] #

拠点:object

PDF 参照オブジェクト。

PdfFile.reserveObject() を使用して参照を作成します。

pdfRepr ( ) [ソース] #
書き込み(内容ファイル) [ソース] #
クラス matplotlib.backends.backend_pdf. RendererPdf (ファイル image_dpi高さ) [ソース] #

拠点:RendererPDFPSBase

check_gc ( gc , fillcolor = None ) [ソース] #
draw_gouraud_triangle ( gc , points , colors , trans ) [source] #

グーロー シェーディングの三角形を描画します。

パラメータ:
GCGraphicsContextBase

グラフィックス コンテキスト。

ポイント(3, 2) 配列のような

三角形の (x, y) 点の配列。

(3, 4) 配列のような

三角形の各点の RGBA カラー。

変身matplotlib.transforms.Transform

ポイントに適用するアフィン変換。

draw_gouraud_triangles ( gc , points , colors , trans ) [source] #

一連のグーロー三角形を描きます。

パラメータ:
ポイント(N, 3, 2) 配列のような

三角形のN (x, y) ポイントの配列。

(N, 3, 4) 配列のようなもの

三角形の各ポイントのN RGBA カラーの配列。

変身matplotlib.transforms.Transform

ポイントに適用するアフィン変換。

draw_image ( gc , x , y , im , transform = None ) [source] #

RGBA イメージを描画します。

パラメータ:
GCGraphicsContextBase

クリッピング情報を含むグラフィック コンテキスト。

xスカラー

キャンバスの左側からの物理単位 (つまり、ドットまたはピクセル) での距離。

yスカラー

キャンバスの下側からの物理単位 (つまり、ドットまたはピクセル) での距離。

im (N, M, 4) np.uint8 の配列のようなもの

RGBA ピクセルの配列。

変身matplotlib.transforms.Affine2DBase

option_scale_imageが を返すように具体的なバックエンドが記述されている場合にのみ True、アフィン変換 (つまりAffine2DBase)に渡すことができますdraw_image。変換の平行移動ベクトルは、物理単位 (つまり、ドットまたはピクセル) で指定されます。変換はxyをオーバーライドせず、結果をxyで変換するに適用する必要があることに注意してください (これは、 transformで定義された変換ベクトルにxyを追加することで実現できます)。

draw_markers ( gc , marker_path , marker_trans , path , trans , rgbFace = None ) [source] #

pathの各頂点 (制御点を除く)にマーカーを描画します。

基本 (フォールバック) 実装は、 を複数回呼び出しますdraw_path。バックエンドは、マーカーを一度だけ描画して複数回再利用するために、このメソッドをオーバーライドしたい場合があります。

パラメータ:
GCGraphicsContextBase

グラフィックス コンテキスト。

マーカートランスmatplotlib.transforms.Transform

マーカーに適用されるアフィン変換。

トランスmatplotlib.transforms.Transform

パスに適用されるアフィン変換。

draw_mathtext ( gc , x , y , s , prop , angle ) [source] #
draw_path ( gc , path , transform , rgbFace = None ) [source] #

Path指定されたアフィン変換を使用してインスタンスを描画します。

draw_path_collection ( gc , master_transform , paths , all_transforms , offsets , offset_trans , facecolors , edgecolors , linewidths , linestyles , antialiaseds , urls , offset_position ) [source] #

パスのコレクションを描画します。

各パスはまずall_transforms ((3, 3) 行列のリスト) の対応するエントリによって変換され、次に master_transformによって変換されます。次に、 offset_transによって最初に変換された、offsetsの対応するエントリによって変換されます。

facecolorsedgecolorslinewidthslinestyles 、および antialiasedは、対応するプロパティを設定するリストです。

offset_positionは現在使用されていませんが、後方互換性のために引数が保持されています。

基本 (フォールバック) 実装は、 を複数回呼び出しますdraw_path。バックエンドは、パス データの各セットを 1 回だけレンダリングし、そのパスをさまざまなオフセット、色、スタイルなどで複数回参照するために、これをオーバーライドすることができます。ジェネレーター メソッド _iter_collection_raw_paths_iter_collectionは、実装を支援 (および標準化) するために提供されています。バックエンド全体。draw_path_collectionの動作をグローバルに変更できるように、これらのジェネレータを使用することを強くお勧めします。

draw_tex ( gc , x , y , s , prop , angle , * , mtext = None ) [source] #
draw_text ( gc , x , y , s , prop , angle , ismath = False , mtext = None ) [source] #

テキスト インスタンスを描画します。

パラメータ:
GCGraphicsContextBase

グラフィックス コンテキスト。

×フロート

表示座標におけるテキストの x 位置。

yフロート

表示座標におけるテキスト ベースラインの y 位置。

s str

テキスト文字列。

小道具matplotlib.font_manager.FontProperties

フォントのプロパティ。

アングルフロート

反時計回りの回転角度 (度単位)。

マルチテキストmatplotlib.text.Text

レンダリングする元のテキスト オブジェクト。

ノート

バックエンドの実装者への注意:

バウンディング ボックスが正しく作成されているかどうか (これにより、テキストのレイアウト/配置が適切に機能するようになります) を判断しようとしている場合は、text.py の行を変更すると役立ちます。

if 0: bbox_artist(self, renderer)

if 1 にすると、実際の境界ボックスがテキストと共にプロットされます。

encode_string ( s , fonttype ) [ソース] #
ファイナライズ( ) [ソース] #
get_image_magnification ( ) [ソース] #

に渡されたイメージを拡大する係数を取得しdraw_imageます。バックエンドが他のアーティストとは異なる解像度の画像を持つことを許可します。

new_gc ( ) [ソース] #

のインスタンスを返しますGraphicsContextBase

クラス matplotlib.backends.backend_pdf. Stream ( id , len , file , extra =なし, png =なし) [source] #

拠点:object

PDF ストリーム オブジェクト。

これには pdfRepr メソッドがありません。代わりに、begin() を呼び出してから、write() を呼び出してストリームの内容を出力し、最後に end() を呼び出します。

パラメータ:
id int

ストリームのオブジェクト ID。

len参照またはなし

ストリームの長さに対する未使用の Reference オブジェクト。None は、長さをインライン化できるようにメモリ バッファーを使用することを意味します。

ファイルPdfファイル

ストリームを書き込む基になるオブジェクト。

Name から何かへの追加辞書、または None

ストリーム ヘッダーに含める追加のキーと値のペア。

png dict または None

データが既に png エンコードされている場合は、デコード パラメータ。

圧縮obj #
終了( ) [ソース] #

ストリームをファイナライズします。

余分な#
ファイル番号
ID番号
レンズ番号
pdfファイル番号
位置番号
書き込み(データ) [ソース] #

ストリームにデータを書き込みます。

クラス matplotlib.backends.backend_pdf. Verbatim ( x ) [ソース] #

拠点:object

後でストリームに含めるために、そのままの PDF コマンド コンテンツを保存します。

pdfRepr ( ) [ソース] #
matplotlib.backends.backend_pdf. fill (文字列, linelen = 75 ) [ソース] #

[非推奨]

ノート

バージョン 3.6 以降非推奨:代わりに _fill のベンダー コピーを使用してください。

matplotlib.backends.backend_pdf. pdfRepr ( obj ) [ソース] #

Python オブジェクトを PDF 構文にマップします。