rendererinfo

グラフィックスレンダラー情報

ページ内をすべて折りたたむ

構文

info = rendererinfo

info = rendererinfo(target)

説明

例

info = rendererinfo は、現在の MATLAB^® セッションの既定のレンダラー情報を含む構造体を返します。

例

info = rendererinfo(target) は、ターゲットグラフィックスオブジェクトのレンダラー情報を含む構造体を返します。target は、任意のタイプの座標軸またはスタンドアロンの可視化として指定します。n 個の座標軸またはスタンドアロンの可視化の配列を指定することもできます。その場合、info は 1 行 n 列の構造体配列として返されます。

例

すべて折りたたむ

既定のレンダラー情報

ライブスクリプトを開く

現在のセッションの既定のレンダラー情報を取得します。

info = rendererinfo

info = struct with fields:
    GraphicsRenderer: 'OpenGL Software'
              Vendor: 'Brian Paul'
             Version: '2.1 Mesa 17.1.3'
      RendererDevice: 'Mesa X11'
             Details: [1x1 struct]

座標軸に関する情報

関数 peaks の表面プロットを作成します。

surf(peaks)

Surface plot of the peaks function

現在の座標軸を取得し、座標軸のレンダラー情報を取得します。システムによって、返される情報が異なる可能性があります。

ax = gca;
info = rendererinfo(ax)

info = 

  struct with fields:

    GraphicsRenderer: 'OpenGL Hardware'
              Vendor: 'NVIDIA Corporation'
             Version: '4.6.0 NVIDIA 391.58'
      RendererDevice: 'Quadro P600/PCIe/SSE2'
             Details: [1×1 struct]

ドライバーの詳細を取得します。

info.Details

ans = 

  struct with fields:

           RendererDriverVersion: '23.21.13.9174'
       RendererDriverReleaseDate: '2018-6-4'
            HardwareSupportLevel: 'Full'
    SupportsDepthPeelTransparency: 1
       SupportsAlignVertexCenters: 1
       SupportsGraphicsSmoothing: 1
                  MaxTextureSize: 32768
              MaxFrameBufferSize: 32768

複数のターゲットオブジェクトに関する情報

Figure 内にヒートマップチャートおよび散布図を作成します。

tiledlayout(1,2)
nexttile
h = heatmap(rand(5));
ax1 = nexttile;
scatter(ax1,1:10,rand(1,10))

Heatmap chart next to a scatter plot

ヒートマップチャートおよび散布図の親座標軸のレンダラー情報を取得します。この場合、info は 2 つの構造体を含む配列です。

info = rendererinfo([h ax1])

info = 

  1×2 struct array with fields:

    GraphicsRenderer
    Vendor
    Version
    RendererDevice
    Details

配列にインデックスを付けてヒートマップチャートのレンダラーのバージョンを取得します。システムによって、返されるバージョン情報が異なる可能性があります。

info(1).Version

ans =

    '4.6.0 NVIDIA 391.74'

入力引数

すべて折りたたむ

`target` — ターゲットオブジェクト
座標軸 | スタンドアロンの可視化 | 座標軸またはスタンドアロンの可視化の配列

ターゲットオブジェクト。次のいずれかとして指定します。

Axes、PolarAxes または GeographicAxes オブジェクトなどの任意の座標軸タイプ。
heatmap などのスタンドアロンの可視化。
座標軸、スタンドアロンの可視化、またはそれらの組み合わせの配列。

出力引数

すべて折りたたむ

`info` — レンダラー情報
構造体

レンダラー情報。グラフィックスレンダラーの名前、ベンダーおよびバージョンなどの情報を含む構造体として返されます。Details フィールドは、詳細を含む入れ子にされた構造体です。次の表は、info 構造体と info.Details 構造体の両方についてまとめています。

target を n 座標軸またはスタンドアロンの可視化の配列として指定する場合、info は、1 行 n 列の構造体配列として返されます。配列内の各構造体は target の要素に対応します。

info 構造体

すべてのシステムで次のフィールドが返されます。

フィールド	説明
`GraphicsRenderer`	グラフィックスレンダラー。次のいずれかの値が返されます。 `'OpenGL Hardware'` `'OpenGL Software'` `'MathWorks Painters'` `'WebGL'`
`Vendor`	グラフィックスレンダラー実装の製造元。
`Version`	グラフィックスレンダラー実装のバージョン。
`RendererDevice`	グラフィックスレンダラーをサポートするデバイス。ハードウェアアクセラレータ版のグラフィックスを使用している場合、このフィールドはグラフィックスカードのモデル名になります。
`Details`	レンダラーのドライバーのバージョンなどの詳細を含む入れ子にされた構造体。Painters レンダラーの場合、この構造体は空です。

details 構造体

一部のシステムでは、グラフィックスレンダラーに応じてこれらのフィールドのサブセットが返されます。Painters レンダラーの場合、info.Details 構造体は空です。

フィールド	説明
`RendererDriverVersion`	OpenGL^® ドライバーのバージョン。このフィールドは、ハードウェアアクセラレータ版の OpenGL を実行している Windows^® システムでのみ表示されます。このフィールドはバーチャルマシンでは表示されません。
`RendererDriverReleaseDate`	OpenGL ドライバーのリリース日付。このフィールドは、ハードウェアアクセラレータ版の OpenGL を実行している Windows システムでのみ表示されます。このフィールドはバーチャルマシンでは表示されません。
`HardwareSupportLevel`	ハードウェアのサポートレベル。次のいずれかの値が返されます。 `'Full'` — MATLAB は、高度なグラフィックス機能を提供するためにグラフィックスハードウェアを最大限使用します。ハードウェアアクセラレータ版の OpenGL および WebGL™ を実行するほとんどのシステムでは、この値が返されます。 `'Basic'` — MATLAB はグラフィックスハードウェアを使用しますが、一部の機能が無効になっています。グラフィックスの表示の問題を回避するために、グラフィックス機能を無効にすることが必要になる場合があります。 `'None'` — MATLAB は、グラフィックスハードウェアを使用しません。ソフトウェア OpenGL を実行しているすべてのシステムでは、この値が返されます。一部のシステムでは、特定の機能のソフトウェア実装がサポートされている場合があります。また、MATLAB でサポートされないドライバーが検出された場合は、このフィールドには `'known graphics driver issues'` が含まれます。
`SupportsDepthPeelTransparency`	深度剥離による透明度機能のサポート。サポートされる場合は `logical(1)`、そうでない場合は `logical(0)` が返されます。
`SupportsAlignVertexCenters`	頂点の中心揃え機能のサポート。サポートされる場合は `logical(1)`、そうでない場合は `logical(0)` が返されます。
`SupportsGraphicsSmoothing`	グラフィックスの平滑化機能のサポート。サポートされる場合は `logical(1)`、そうでない場合は `logical(0)` が返されます。
`MaxTextureSize`	レンダラーがサポートする最大テクスチャサイズ (ピクセル単位)。
`MaxFrameBufferSize`	レンダラーがサポートする最大フレームバッファーサイズ (ピクセル単位)。

詳細

すべて折りたたむ

高度なグラフィックス機能

高度なグラフィックス機能には、特定のレンダラー実装が必要とされます。これにはグラフィックスの平滑化、深度剥離による透明度、頂点の中心揃えおよびハードウェアアクセラレータ版のマーカーがあります。info.Details 構造体の HardwareSupportLevel フィールドの値を取得することで、それらの機能の一部またはすべてがシステムでサポートされているかどうかがわかります。

次の表に、高度なグラフィックス機能と、各機能がサポートされる環境を示します。場合によっては、特定の機能がサポートされていても、グラフィックスの表示の問題を回避するために無効になっています。

グラフィックス機能	ハードウェア版 OpenGL	ハードウェア基本機能版 OpenGL	Windows のソフトウェア版 OpenGL	Linux^® のソフトウェア版 OpenGL	WebGL
グラフィックスの平滑化	OpenGL 2.1 以降でサポート	OpenGL 2.1 以降でサポート	サポートなし	サポートなし	サポートあり
深度剥離による透明度	OpenGL 2.1 以降でサポート	無効	サポートなし	サポートあり	サポートあり
頂点の中心揃え	OpenGL 2.1 以降でサポート	無効	サポートなし	サポートなし	サポートあり
ハードウェアアクセラレータ版のマーカー	OpenGL 4.0 以降でサポート	無効	サポートなし	サポートなし	サポートあり

グラフィックスの平滑化

グラフィックスの平滑化は、線のギザギザを滑らかにしてプロットの外観を改善します。この機能がシステムでサポートされる場合、既定では有効になっています。特定の Figure に対してこの機能をオフにするには、Figure の GraphicsSmoothing プロパティを 'off' に設定します。

次の表では、この機能が有効の場合と無効の場合の違いを説明します。

サポートされ有効にされている場合	サポートされないか無効にされている場合

(拡大表示)	(拡大表示)

サポートされ有効にされている場合

サポートされないか無効にされている場合

Axes graphic with smoothing. The plotted line appears smooth.

Axes graphic with no smoothing. The plotted line appears jagged.

(拡大表示)

Zoomed-in view of axes graphic with smoothing. The pixels near the edge of the graphic gradually transition from the blue graphic color to the white background color.

(拡大表示)

Zoomed-in view of axes graphic with no smoothing. The color of each pixel is either the blue graphic color or the white background color, with no gradual transition between the two.

深度剥離による透明度

深度剥離による透明度は、半透明な 3 次元オブジェクトや、交差する半透明なオブジェクトを含むプロットを正しく描画するための機能です。次の表の左側のイメージは、深度剥離による透明度機能がサポートされる場合の球面の描画結果を示します。右側のイメージは、この機能がサポートされない場合の同じ球面の描画結果です。この球面には予期しない影付きの部分が含まれています。

サポートされる場合

サポートされない場合

Semitransparent surface plot of a sphere

Semitransparent surface plot of a sphere that has randomly shaded sections inside the sphere (visual artifacts)

頂点の中心揃え

頂点の中心揃えは、垂直および水平のラインを鮮明にする機能です。グラフィックスの平滑化が有効にされている場合、垂直や水平のラインの太さや色が不均等である場合があります。頂点の中心揃え機能によって、この不均等な外観をなくします。既定では、頂点の中心揃え機能が無効にされています。ただし、システムでサポートされる場合には、AlignVertexCenters プロパティをもつオブジェクトについて、このプロパティを 'on' に設定して有効にすることができます。

次の表では、この機能が有効の場合と無効の場合の違いを説明します。

サポートされ有効にされている場合

サポートされないか無効にされている場合

Four vertical lines that are sharp

Four vertical lines that are uneven in thickness. Some of the lines are blurry.

ハードウェアアクセラレータ版のマーカー

ハードウェアアクセラレータ版のマーカーは、パフォーマンスと品質を向上させるためにグラフィックスハードウェアを活用します。次の表では、この機能がサポートされている場合とサポートされていない場合の違いを説明します。

サポートされる場合

サポートされない場合

Five-pointed star with mitered (pointed) vertices

Five-pointed star with notched vertices

ヒント

代わりに Painters を使用して画面表示と印刷用のレンダリングを行うこともできます。詳細については、Figure の Renderer プロパティを参照してください。
既定では、MATLAB は、グラフィックスハードウェアによってサポートされている場合には、ハードウェアアクセラレータ版のグラフィックスの使用を試みます。ただし、MATLAB によって次の状況のいずれかが検出される場合には、ソフトウェア実装に自動的に切り替えられることもあります。
- 既知の問題やグラフィックス仮想化機能のあるグラフィックスドライバーを使用している場合。
- 以前の MATLAB セッションが、グラフィックスの問題が原因でクラッシュした場合。以前のセッションがソフトウェア版の OpenGL を使用していてクラッシュした場合、後続のセッションでは、機能の少ない、より安定したバージョンのソフトウェア版 OpenGL を使用します。
- 必要なグラフィックスハードウェアがシステムに含まれてない場合。

バージョン履歴

R2019a で導入

すべて展開する

R2022a: 入力引数なしでの `rendererinfo` の呼び出しに対する追加サポート

引数なしで関数 rendererinfo を呼び出し、既定のグラフィックスレンダラー情報をクエリします。この新しい構文では、関数 rendererinfo を opengl 構文と整合的な方法で呼び出すことができます。

R2019a: `opengl` よりも推奨

rendererinfo は、特定の座標軸やスタンドアロンの可視化についてレンダラー情報を提供でき、また WebGL レンダラーに関する情報を報告できます。関数 opengl では、こうした機能は提供されません。

参考

opengl | matlab (Windows) | matlab (Linux) | matlab (macOS)

rendererinfo

構文

説明

例

既定のレンダラー情報

座標軸に関する情報

複数のターゲット オブジェクトに関する情報

入力引数

target — ターゲット オブジェクト 座標軸 | スタンドアロンの可視化 | 座標軸またはスタンドアロンの可視化の配列

出力引数

info — レンダラー情報 構造体

info 構造体

details 構造体

詳細

高度なグラフィックス機能

グラフィックスの平滑化

深度剥離による透明度

頂点の中心揃え

ハードウェア アクセラレータ版のマーカー

ヒント

バージョン履歴

R2022a: 入力引数なしでの rendererinfo の呼び出しに対する追加サポート

R2019a: opengl よりも推奨

参考

トピック

複数のターゲットオブジェクトに関する情報

`target` — ターゲットオブジェクト
座標軸 | スタンドアロンの可視化 | 座標軸またはスタンドアロンの可視化の配列

`info` — レンダラー情報
構造体

ハードウェアアクセラレータ版のマーカー

R2022a: 入力引数なしでの `rendererinfo` の呼び出しに対する追加サポート

R2019a: `opengl` よりも推奨