IDirect3DDevice9::D rawRectPatch 方法 (d3d9helper.h)

使用当前设置的流绘制矩形补丁。

语法

HRESULT DrawRectPatch(
  [in] UINT                    Handle,
  [in] const float             *pNumSegs,
  [in] const D3DRECTPATCH_INFO *pRectPatchInfo
);

参数

[in] Handle

类型: UINT

要绘制的矩形补丁的句柄。

[in] pNumSegs

类型: const float*

指向由四个浮点值构成的数组的指针,这些值标识矩形补丁的每个边缘在细化时应划分的段数。 请参阅 D3DRECTPATCH_INFO

[in] pRectPatchInfo

类型: const D3DRECTPATCH_INFO*

指向 D3DRECTPATCH_INFO 结构的指针,描述要绘制的矩形补丁。

返回值

类型: HRESULT

如果方法成功,则返回值D3D_OK。 如果 方法失败,则可以D3DERR_INVALIDCALL返回值。

注解

对于静态修补程序:设置顶点着色器,设置适当的流,在 pRectPatchInfo 参数中提供修补程序信息,并指定句柄,以便 Direct3D 可以捕获和缓存信息。 随后调用 IDirect3DDevice9::D rawRectPatch, 并将 pRectPatchInfo 设置为 NULL ,以有效地绘制修补程序。 绘制缓存的修补程序时,将忽略当前设置的流。 通过为 pNumSegs 指定新值来替代缓存的 pNumSegs。 呈现缓存的修补程序时,必须设置与捕获时设置的顶点着色器相同的着色器。

使用句柄调用 IDirect3DDevice9::D rawRectPatch 会使以前的 IDirect3DDevice9::D rawTriPatch 调用缓存的同一句柄失效。

对于动态修补程序,每次呈现修补程序时,修补程序数据都会发生更改,因此缓存信息效率不高。 应用程序可以通过将“句柄”设置为 0 来向 Direct3D 传达此信息。 在这种情况下,Direct3D 使用当前设置的流和 pNumSegs 值绘制修补程序,并且不缓存任何信息。 同时将 Handle 设置为 0 和 pRectPatchInfo 设置为 NULL 无效。

要求

要求
目标平台 Windows
标头 d3d9helper.h (包括 D3D9.h)
Library D3D9.lib

另请参阅

IDirect3DDevice9

IDirect3DDevice9::D eletePatch

使用 Higher-Order 基元 (Direct3D 9)