主要内容

本页翻译不是最新的。点击此处可查看最新英文版本。

rendererinfo

图形渲染器信息

说明

info = rendererinfo 返回一个结构体,其中包含当前 MATLAB® 会话的默认渲染器信息。

示例

info = rendererinfo(target) 返回包含目标图形对象的渲染器信息的结构体。将 target 指定为任何类型的坐标区或独立可视化。您还可以指定由 n 个坐标区或独立可视化组成的数组,在这种情况下,info 以 1×n 结构体数组形式返回。

示例

示例

全部折叠

获取当前会话的默认渲染器信息。

info = rendererinfo
info = struct with fields:
    GraphicsRenderer: 'WebGL'
              Vendor: 'Google Inc. (Google)'
             Version: 'WebGL 2.0 (OpenGL ES 3.0 Chromium)'
      RendererDevice: 'ANGLE (Google, Vulkan 1.2.0 (SwiftShader Device (Subzero) (0x0000C0DE)), SwiftShader driver)'
             Details: [1×1 struct]

创建 peaks 函数的曲面图。

surf(peaks)

Surface plot of the peaks function

获取当前坐标区,然后获取坐标区的渲染器信息。您的系统可能会返回不同信息。

ax = gca;
info = rendererinfo(ax)
info = 

  struct with fields:

    GraphicsRenderer: 'WebGL'
              Vendor: 'Google Inc. (NVIDIA)'
             Version: 'WebGL 2.0 (OpenGL ES 3.0 Chromium)'
      RendererDevice: 'ANGLE (NVIDIA, NVIDIA Quadro P600 (0x00001CB2) Direct3D11 vs_5_0 ps_5_0, D3D11)'
             Details: [1×1 struct]

获取驱动详细信息。

info.Details
ans = 

  struct with fields:

             HardwareSupportLevel: 'Full'
    SupportsDepthPeelTransparency: 1
       SupportsAlignVertexCenters: 1
        SupportsGraphicsSmoothing: 1
                   MaxTextureSize: 16384
               MaxFrameBufferSize: 16384

在图窗中创建一个热图和一个散点图。

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 是包含两个结构体的数组。

info = rendererinfo([h ax1])
info = 

  1×2 struct array with fields:

    GraphicsRenderer
    Vendor
    Version
    RendererDevice
    Details

对数组进行索引以获取热图的渲染器版本。您的系统可能会返回不同的版本信息。

info(1).Version
ans =

    'WebGL 2.0 (OpenGL ES 3.0 Chromium)'

输入参数

全部折叠

目标对象,指定为下列值之一:

  • 任何坐标区类型,例如 AxesPolarAxesGeographicAxes 对象。

  • 独立可视化,如 heatmap

  • 坐标区、独立可视化或其组合组成的数组。

输出参量

全部折叠

渲染器信息,返回为结构体,其中包含图形渲染器名称、供应商和版本等信息。Details 字段是嵌套结构体,包含其他详细信息。下表说明 info 结构体和 info.Details 结构体。

如果您将 target 指定为 n 个坐标区或独立可视化的数组,info 将返回为 1×n 结构体数组。数组中的每个结构体对应于 target 的一个元素。

Info 结构体

所有系统都会返回以下字段。

字段描述
GraphicsRenderer

图形渲染器,返回为下列值之一:

  • 'WebGL'

  • 'SwiftShader'

Vendor

图形渲染器实现的制造商。

Version

图形渲染器实现的版本。

RendererDevice

支持图形渲染器的设备。如果您在使用硬件加速图形,则此字段是显卡型号名称。

Details

嵌套结构体,其中包含其他详细信息,例如渲染器的驱动版本。对于 Painters 渲染器,此结构体为空。

Details 结构体

Details 结构体包含以下字段。

在 R2025a 之前的版本中: 有些系统会根据图形渲染器返回这些字段的子集。

字段描述
HardwareSupportLevel

硬件支持级别,以下列值之一形式返回:

  • 'Full' - MATLAB 尽可能使用图形硬件来提供高级图形功能,如图形平滑和对齐的顶点中心。大多数系统返回此值。

  • 'Basic' - MATLAB 使用图形硬件,但某些功能被禁用。

  • 'None' - MATLAB 不使用任何图形硬件。

SupportsDepthPeelTransparency

深度剥离透明度功能支持,如果支持,则返回 logical(1),否则返回 logical(0)

SupportsAlignVertexCenters

对齐顶点中心功能支持,如果支持,则返回 logical(1),否则返回 logical(0)

SupportsGraphicsSmoothing

图形平滑处理功能支持,如果支持,则返回 logical(1),否则返回 logical(0)

MaxTextureSize

渲染器支持的最大纹理大小(以像素为单位)。

MaxFrameBufferSize

渲染器支持的最大帧缓冲区大小(以像素为单位)。

版本历史记录

在 R2019a 中推出

全部展开