a base class for rendering objects using dynamic buffer from memory data. More...
#include <DynamicRenderable.h>
Inheritance diagram for ParaEngine::CDynamicRenderable:
Public Member Functions | |
| HRESULT | DrawPrimitive (D3DPRIMITIVETYPE PrimitiveType, UINT StartVertex, UINT PrimitiveCount) |
| HRESULT | DrawIndexedPrimitive (D3DPRIMITIVETYPE Type, INT BaseVertexIndex, UINT MinIndex, UINT NumVertices, UINT StartIndex, UINT PrimitiveCount) |
| Based on indexing, renders the specified geometric primitive into an array of vertices. | |
| void | PrepareBuffers (int nVertexCount, int nIndexCount) |
| call this function when the vertex or index buffer size changes. More... | |
| bool | lock () |
| it locks everything for the caller to prevent simultaneous access. More... | |
| bool | unlock () |
| it unlocks everything for the caller to prevent simultaneous access. More... | |
Public Attributes | |
| int | m_nFVF |
| int | m_nVertexBufSize |
| int | m_nIndexBufSize |
| vector< Vector3 > | m_Positions |
| vector< Vector3 > | m_Normals |
| vector< DWORD > | m_Colors |
| vector< Vector2 > | m_UVs |
| vector< unsigned short > | m_indices |
Detailed Description
a base class for rendering objects using dynamic buffer from memory data.
it does not create vertex or index buffer, instead it just feeds raw triangles into the dynamic buffer Usage: derive your class or keep a member of this class.
- call PrepareBuffers()
- fill or update in the the vertex and index buffer data in memory by directly manipulating m_Positons, m_indices, etc. inside lock/unlock pairs.
- on each render frame, call DrawPrimitive or DrawIndexedPrimitive. Note: Dynamic renderable object uses system memory to store vertex and index buffer, making it extremely simple to update the vertex per frame. however, the performance is not good as hardware buffers. CDynamicRenderable is therefore only used for per vertex animated objects, and objects in editing mode, such as an editable voxel mesh.
Member Function Documentation
§ lock()
| bool ParaEngine::CDynamicRenderable::lock | ( | ) |
it locks everything for the caller to prevent simultaneous access.
§ PrepareBuffers()
| void ParaEngine::CDynamicRenderable::PrepareBuffers | ( | int | nVertexCount, |
| int | nIndexCount | ||
| ) |
call this function when the vertex or index buffer size changes.
- Parameters
-
nVertexCount size of the vertex buffer nIndexCount size of the index buffer, if 0 index buffer is not used.
§ unlock()
| bool ParaEngine::CDynamicRenderable::unlock | ( | ) |
it unlocks everything for the caller to prevent simultaneous access.
The documentation for this class was generated from the following files:
- Client/trunk/ParaEngineClient/Engine/DynamicRenderable.h
- Client/trunk/ParaEngineClient/Engine/DynamicRenderable.cpp
