Welcome to
www.tdxlibrary.org
Home of the
the TDx_Library...
"RAD DirectX"
for
C++ Builder
...
- Description
The TDx_3DDevice::DrawIndexedPrimitive() method will render a geometric primitive by indexing into a vertex array.
Ensure the vertices to be rendered match the vertex format or memory faults may result.
The entire array is transformed, so do not use this method to render a small subset from a large array.
This method somtimes generates a larger update rectangle than is needed, affecting performance when many vertices are processed.
If using TD3DTLVertex and this is occurring, set D3DDP_DONOTCLIP and D3DDP_DONOTUPDATEEXTENTS flags to remedy the situation.
If the method call fails, the OnError event will be triggered with one of the following values:
D3DERR_INVALIDRAMPTEXTURE
D3DERR_INVALIDPRIMITIVETYPE
D3DERR_INVALIDVERTEXTYPE
DDERR_INVALIDPARAMS
DDERR_WASSTILLDRAWING
- Parameters
PrimitiveType
The PrimitiveType parameter defines the type of primitive that is to be rendered.
Possible values are:
D3DPT_LINELIST
D3DPT_LINESTRIP
D3DPT_TRIANGLELIST
D3DPT_TRIANGLESTRIP
D3DPT_TRIANGLEFAN
VertexTypeDesc
The VertexTypeDesc parameter indicates the vertex format by setting a combination of flexible vertex format flags.
The flexible vertex format flags used correspond to those described in TD3DVertexBufferFormat::FVF.
Vertices
The Vertices parameter references the vertex array from which vertices will be rendered as specified by the indices in the Indices array.
VertexCount
The VertexCount parameter defines the total number of vertices stored in the Vertices array.
Indices
The Indices parameter references a WORD array of values for indexing into the Vertices array.
IndexCount
The IndexCount parameter defines how many indices are in the Indices array and thus how many vertices are to be drawn from the Vertices array.
Flags
The Flags parameter indicates whether the method should wait for rendering before returning.
The described effect applies when the flag is set.
Set 0 to return as soon as the polygons are sent to the card.
-
D3DDP_WAIT
Wait until rendering has been done rather than returning as soon as the data has been sent to the card.
The method will return immediately when a scene capture cards responds.
Usually for debugging, do not use this flag to ensure the scene is up to date before continuing.
- See Also
- Top
TDx_3DI_Library v2.00 Component Reference
|
|
|
[ TDx_3DDevice::DrawIndexedPrimitive() ] [ next: DrawIndexedPrimitiveStrided() ] [ prev: Destroy() ] public:
virtual bool __fastcall DrawIndexedPrimitive( D3DPRIMITIVETYPE pPrimitiveType, dword pVertexTypeDesc, void* pVertices, dword pVertexCount, word* pIndices, dword pIndexCount, dword pFlags );
TDX_3DDEVICE::DRAWINDEXEDPRIMITIVE()
[ component method ]
If you would like to submit additions or improvements to this page, click: darren_john_dwyer@hotmail.com. |
|