IDirect3DDevice9::D rawRectPatch-Methode (d3d9.h)

Artikel
08/23/2023

Zeichnet einen rechteckigen Patch mit den aktuell festgelegten Streams.

Syntax

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

Parameter

[in] Handle

Typ: UINT

Handle zum rechteckigen Patch zum Zeichnen.

[in] pNumSegs

Typ: const float*

Zeiger auf ein Array von vier Gleitkommawerten, die die Anzahl der Segmente angeben, die jeder Rand des Rechtecks bei der Tessellierung unterteilt werden soll. Siehe D3DRECTPATCH_INFO.

[in] pRectPatchInfo

Typ: const D3DRECTPATCH_INFO*

Zeiger auf eine D3DRECTPATCH_INFO-Struktur , die den zu zeichnenden rechteckigen Patch beschreibt.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert D3DERR_INVALIDCALL werden.

Hinweise

Für statische Patches: Legen Sie den Vertex-Shader fest, legen Sie die entsprechenden Streams fest, geben Sie Patchinformationen im pRectPatchInfo-Parameter an, und geben Sie ein Handle an, damit Direct3D Informationen erfassen und zwischenspeichern kann. Rufen Sie anschließend IDirect3DDevice9::D rawRectPatch auf , wobei pRectPatchInfo auf NULL festgelegt ist, um den Patch effizient zu zeichnen. Beim Zeichnen eines zwischengespeicherten Patches werden die aktuell festgelegten Streams ignoriert. Überschreiben Sie die zwischengespeicherten pNumSegs, indem Sie einen neuen Wert für pNumSegs angeben. Beim Rendern eines zwischengespeicherten Patches müssen Sie den gleichen Vertex-Shader festlegen, der bei der Erfassung festgelegt wurde.

Wenn IDirect3DDevice9::D rawRectPatch mit einem Handle aufgerufen wird, wird dasselbe Handle ungültig, das von einem vorherigen IDirect3DDevice9::D rawTriPatch-Aufruf zwischengespeichert wurde.

Bei dynamischen Patches ändern sich die Patchdaten für jedes Rendering des Patches, sodass es nicht effizient ist, Informationen zwischenzuspeichern. Die Anwendung kann dies auf Direct3D übertragen, indem Handle auf 0 festgelegt wird. In diesem Fall zeichnet Direct3D den Patch mit den aktuell festgelegten Streams und den pNumSegs-Werten und speichert keine Informationen zwischen. Es ist nicht gültig, Handle gleichzeitig auf 0 und pRectPatchInfo auf NULL festzulegen.