pyvista.Plotter.enable_anti_aliasing#

Plotter.enable_anti_aliasing(aa_type='ssaa', multi_samples=None, all_renderers=True)[ソース]#

アンチエイリアスを有効にします．

これにより，境界が柔らかくなり，ピクセル感がなくなる傾向があります．

パラメータ:
aa_typestr, default: "ssaa"

アンチエイリアスの種類．以下の注意事項を参照してください．以下のいずれか．

  • "ssaa" - スーパーサンプリングアンチエイリアシング

  • "msaa" - マルチサンプルアンチエイリアシング

  • "fxaa" - 高速近似アンチエイリアシング

multi_samplesint, optional

aa_type が "msaa" のときのマルチサンプルの数です．この設定を使用すると，すべてのレンダラーで自動的にこの設定が有効になることに注意してください．デフォルトでは，テーマのmulti_samplesが設定されます．

all_renderersbool, default: True

True の場合，サブプロットのすべてのレンダラーに適用されます． False の場合，アクティブなレンダラーにのみ適用されます．

備考

SSAAまたはスーパーサンプルアンチエイリアシングは，アンチエイリアシングのブルートフォース当り方式です．最高の画質が得られますが，膨大なリソースコストがかかります．SSAAは，シーンをより高い解像度でレンダリングすることで機能します．最終的な画像は，平均化フィルタを使用して巨大なソース画像をダウンサンプリングすることによって生成されます．これはローパスフィルタとして機能し，ギザギザの原因となる高周波成分を除去します．

MSAAまたはマルチサンプルアンチエイリアスは，SSAAの最適化で，シーンの重複する領域に焦点を当てることで，計算が必要なピクセルシェーダーの評価量を削減します．その結果，エッジに沿ったアンチエイリアシングはSSAAと同等になり，サーフェスに沿ったアンチエイリアシングはSSAAの計算の大部分を占めるため，より少なくなります．MSAAはSSAAに比べ大幅に計算量が少なく，同等の画質が得られます．

FXAA または Fast Approximate Anti-Aliasing は，アンチエイリアシング技術の一つで，完全にポストプロセスで実行されます．FXAAは，シーンのジオメトリではなく，ラスタライズされた画像に対して動作します．そのため，FXAAを強制したり，FXAAを誤って使用すると，FXAAフィルターが，鮮明さのために通常シャープに保たれる視覚的オーバーレイの一部を平滑化したり，テクスチャを平滑化したりすることがあります．FXAA は MSAA よりも劣りますが，計算上はほとんど自由に使えるため，ローエンドのプラットフォームで は望ましいと言えます．

例

スーパーサンプルアンチエイリアシング（SSAA）を有効にします．

>>> import pyvista as pv
>>> pl = pv.Plotter()
>>> pl.enable_anti_aliasing('ssaa')
>>> _ = pl.add_mesh(pv.Sphere(), show_edges=True)
>>> pl.show()
../../../_images/pyvista-Plotter-enable_anti_aliasing-1_00_00.png

VTK のアンチエイリアシングのアプローチを示す完全な例については， アンチエイリアシング を参照してください．