backend_agg

Anti-Grain Geometry ( AGG) バックエンド。

実装される機能:

• キャップスタイルと結合スタイル

• ダッシュ

• 線幅

• 線、長方形、楕円

• 長方形にクリッピング

• RGBA および Pillow がサポートする画像フォーマットへの出力

• アルファ ブレンディング

• DPI スケーリングが適切 - すべてが適切にスケーリングされます (ダッシュ、線幅など)

• 多角形を描く

• freetype2 と ft2font

まだ TODO:

• 画面の dpi と ppi およびテキストを統合する

matplotlib.backends.backend_agg. FigureCanvas

のエイリアスFigureCanvasAgg

クラス matplotlib.backends.backend_agg. FigureCanvasAgg (図=なし)

拠点:FigureCanvasBase

buffer_rgba ( )

イメージを としてmemoryviewレンダラーのバッファに取得します。

drawこの関数が機能する前に少なくとも 1 回呼び出す必要があり、その後の Figure への変更のためにレンダラーを更新する必要があります。

copy_from_bbox ( bbox )

draw ( )

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

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

get_renderer ( cleared=<非推奨の パラメーター> )

print_jpeg ( filename_or_obj , * args , pil_kwargs = None )

Figure を JPEG ファイルに書き込みます。

パラメータ:

filename_or_obj str またはパス状またはファイル状

書き込むファイル。

pil_kwargs dict、オプション

PIL.Image.Image.saveFigure を保存するときに渡される追加のキーワード引数 。

print_jpg ( filename_or_obj , * args , pil_kwargs = None )

Figure を JPEG ファイルに書き込みます。

パラメータ:

filename_or_obj str またはパス状またはファイル状

書き込むファイル。

pil_kwargs dict、オプション

PIL.Image.Image.saveFigure を保存するときに渡される追加のキーワード引数 。

print_png ( filename_or_obj , * args , metadata = None , pil_kwargs = None )

Figure を PNG ファイルに書き込みます。

パラメータ:

filename_or_obj str またはパス状またはファイル状

書き込むファイル。

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

バイトまたはラテン 1 エンコード可能な文字列のキーと値のペアとしての PNG ファイル内のメタデータ。PNG 仕様によると、キーは 79 文字より短くする必要があります。

PNG 仕様では、必要に応じて使用できるいくつかの一般的なキーワードが定義されています。

• タイトル: 画像の短い (1 行の) タイトルまたはキャプション。

• 作成者: 画像の作成者の名前。

• 説明: 画像の説明 (長い場合もあります)。

• 著作権: 著作権表示。

• 作成時間: 元のイメージの作成時間 (通常は RFC 1123 形式)。

• ソフトウェア: イメージの作成に使用されるソフトウェア。

• 免責事項: 法的免責事項。

• 警告: コンテンツの性質に関する警告。

• ソース: イメージの作成に使用されたデバイス。

• コメント: その他のコメント。他の画像フォーマットからの変換。

他のキーワードは、他の目的のために考案される場合があります。

「Software」が指定されていない場合、Matplotlib の自動生成された値が使用されます。これは、Noneに設定することで削除できます。

詳細については、PNG 仕様を参照してください。

pil_kwargs dict、オプション

に渡されるキーワード引数PIL.Image.Image.save。

「pnginfo」キーが存在する場合 、デフォルトの「Software」キーを含むメタデータを完全にオーバーライドします。

print_raw ( filename_or_obj , * args )

print_rgba ( filename_or_obj , * args )

print_tif ( filename_or_obj , * , pil_kwargs = None )

Figure を TIFF ファイルに書き込みます。

パラメータ:

filename_or_obj str またはパス状またはファイル状

書き込むファイル。

pil_kwargs dict、オプション

PIL.Image.Image.saveFigure を保存するときに渡される追加のキーワード引数 。

print_tiff ( filename_or_obj , * , pil_kwargs = None )

Figure を TIFF ファイルに書き込みます。

パラメータ:

filename_or_obj str またはパス状またはファイル状

書き込むファイル。

pil_kwargs dict、オプション

PIL.Image.Image.saveFigure を保存するときに渡される追加のキーワード引数 。

print_to_buffer ( )

print_webp ( filename_or_obj , * , pil_kwargs = None )

Figure を WebP ファイルに書き込みます。

パラメータ:

filename_or_obj str またはパス状またはファイル状

書き込むファイル。

pil_kwargs dict、オプション

PIL.Image.Image.saveFigure を保存するときに渡される追加のキーワード引数 。

restore_region ( region , bbox = None , xy = None )

tostring_argb ( )

画像を A​​RGB として取得しbytesます。

drawこの関数が機能する前に少なくとも 1 回呼び出す必要があり、その後の Figure への変更のためにレンダラーを更新する必要があります。

tostring_rgb ( )

イメージを RGB として取得しますbytes。

drawこの関数が機能する前に少なくとも 1 回呼び出す必要があり、その後の Figure への変更のためにレンダラーを更新する必要があります。

クラス matplotlib.backends.backend_agg. RendererAgg (幅、高さ、 dpi )

拠点:RendererBase

レンダラーは、色/スタイルを制御するグラフィックス コンテキスト インスタンスを使用して、すべての描画プリミティブを処理します。

buffer_rgba ( )

クリア( )

draw_mathtext ( gc , x , y , s , prop , angle )

を使用して数学テキストを描画しmatplotlib.mathtextます。

draw_path ( gc , path , transform , rgbFace = None )

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

draw_tex ( gc , x , y , s , prop , angle , * , mtext = None )

draw_text ( gc , x , y , s , prop , angle , ismath = False , mtext = None )

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

パラメータ:

GCGraphicsContextBase

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

×フロート

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

yフロート

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

s str

テキスト文字列。

小道具matplotlib.font_manager.FontProperties

フォントのプロパティ。

アングルフロート

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

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

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

ノート

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

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

if 0: bbox_artist(self, renderer)

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

get_canvas_width_height ( )

キャンバスの幅と高さを表示座標で返します。

get_text_width_height_descent ( s , prop , ismath )

propを使用し て、文字列sの幅、高さ、およびディセント (下からベースラインまでのオフセット) を表示座標で取得します。FontProperties

lock = <unlocked _thread.RLock object owner=0 count=0>

option_image_nocomposite ( )

Matplotlib による画像合成をスキップするかどうかを返します。

通常、ラスター バックエンドは False を返す必要があります (C レベルのラスタライザーが画像構成を処理できるようにします)。通常、ベクター バックエンドは を返す必要があります。not rcParams["image.composite_image"]

option_scale_image ( )

の任意のアフィン変換draw_imageがサポートされているかどうかを返します (ほとんどのベクター バックエンドで True)。

points_to_pixels (ポイント)

ポイントを表示単位に変換します。

この関数をオーバーライドする必要があります (ポストスクリプトや svg など、バックエンドに dpi がない場合を除きます)。一部のイメージング システムでは、1 インチあたりのピクセル数に次のような値が想定されます。

points to pixels = points * pixels_per_inch/72 * dpi/72

パラメータ:

ポイントfloat または array-like

float または float の numpy 配列

戻り値:

ピクセルに変換されたポイント

restore_region ( region , bbox = None , xy = None )

保存された領域を復元します。bbox (BboxBase のインスタンスまたはそのエクステント) が指定されている場合、bbox によって指定された領域のみが復元されます。xy (float のペア) は、リージョンが復元される新しい位置 (bbox の LLC ではなく、元のリージョンの LLC) をオプションで指定します。

>>> region = renderer.copy_from_bbox()
>>> x1, y1, x2, y2 = region.get_extents()
>>> renderer.restore_region(region, bbox=(x1+dx, y1, x2, y2),
...                         xy=(x1-dx, y1))

start_filter ( )

フィルタリングを開始します。新しいキャンバスを作成するだけです (古いキャンバスは保存されます)。

stop_filter (後処理)

現在のキャンバスにプロットを画像として保存し、post_processing関数を適用します。

def post_processing (画像、dpi):

# ny, nx, depth = image.shape # 画像 (numpy 配列) には RGBA チャネルがあり、深さは 4 です。 ... # new_image を作成します (4 チャネルの numpy 配列、サイズは # 異なる可能性があります)。結果の画像には、元の画像の左下隅からのオフセットがある場合があります return new_image, offset_x, offset_y

保存されたレンダラーが復元され、post_processing から返された画像が (draw_image を使用して) その上にプロットされます。

tostring_argb ( )

tostring_rgb ( )

matplotlib.backends.backend_agg. get_hinting_flag ( )