|
G3D::PosedModel Class ReferenceBase class for posed models. More...
Inherits G3D::ReferenceCountedObject. Inherited by G3D::IFSModel::PosedIFSModel, and G3D::MD2Model::PosedMD2Model.
Detailed DescriptionBase class for posed models.A posed model is a snapshot of geometry and other rendering information, frozen in time, of a potentially animated or deformable "Model". G3D has no API (but some conventions) for how you get a PosedModel from a model class. G3D does not provide a scene graph structure (e.g. there is no Model base class) because the visible surface determination, rendering, and caching behavior of a scene graph are different for each application. There is currently no one-size-fits-all scene graph design pattern.
G3D does provide some basic infrastructure for making your own scene graph, however. Model classes (e.g. G3D::IFSModel, G3D::MD2Model), which have no common base class, should all implement a Use G3D::PosedModelWrapper to encapsulate an existing posed model with your own. A common strategy when implementing PosedModel is to not compute "derived" values like the object space face normals until they are needed. That is, the first call to a method might be very expensive because it goes off and computes some value that will be cached for future calls. Rendering The easiest way to render is PosedModel::render(). More sophisticated rendering, e.g., in the presence of shadows, can be accomplished with the separate renderShadowMappedLightPass etc. routines. PosedModel also allows you to directly extract and operate on its geometry. This is useful for adding effects like outlines in cartoon rendering, physics hit boxes, and shadow volume rendering. You can directly render from the geometry using the following rendering code (it is much faster if you can avoid re-creating the VARs and VARArea every frame!)
VARAreaRef area = VARArea::create(sizeof(Vector3) * posed->objectSpaceGeometry().vertexArray.size() * 2 + sizeof(Vector2) * posed->texCoords().size());
VAR vertex(posed->objectSpaceGeometry().vertexArray, area);
VAR normal(posed->objectSpaceGeometry().normalArray, area);
VAR texCoord(posed->texCoords(), area);
rd->setObjectToWorldMatrix(posed->coordinateFrame()); rd->setShadeMode(RenderDevice::SHADE_SMOOTH); rd->beginIndexedPrimitives(); rd->setVertexArray(vertex); rd->setNormalArray(normal); rd->setTexCoordArray(0, texCoord); rd->sendIndices(RenderDevice::TRIANGLES, posed->triangleIndices()); rd->endIndexedPrimitives();
Member Typedef Documentation
Constructor & Destructor Documentation
Member Function Documentation
Implementation must obey the current stencil, depth write, color write, and depth test modes. Implementation may freely set the blending, and alpha test modes. Default implementation renders the triangles returned by getIndices and getGeometry.
Implemented in G3D::MD2Model::PosedMD2Model.
Adjacency information respecting the underlying connectivity of the mesh-- colocated vertices are treated as distinct.
Implemented in G3D::MD2Model::PosedMD2Model.
Implemented in G3D::MD2Model::PosedMD2Model.
Implemented in G3D::MD2Model::PosedMD2Model.
Get the world space geometry.
If true, this object depends on back-to-front rendering order and should be rendered in sorted order. Default is false.
Implemented in G3D::MD2Model::PosedMD2Model.
Number of edges that have only one adjacent face in edges(). These boundary edges are all at the end of the edge list. Implemented in G3D::MD2Model::PosedMD2Model.
Number of edges that have only one adjacent face in weldedEdges(). These boundary edges are all at the end of the edge list. Implemented in G3D::MD2Model::PosedMD2Model.
Return a pointer to an array of object space face normals.
Implemented in G3D::MD2Model::PosedMD2Model.
Get the object space geometry (faster than getWorldSpaceGeometry). Object and world space geometry only differ by a CoordinateFrame transformation. Implemented in G3D::MD2Model::PosedMD2Model.
Automatically called immediately before the object is deleted. This is not called from the destructor because it needs to be invoked before the subclass destructor.
Render using current fixed function lighting environment. Do not change the steBehavior with regard to stencil, shadowing, etc. is intentionally undefinded. Default implementation calls defaultRender. Reimplemented in G3D::MD2Model::PosedMD2Model.
Render all terms that are independent of shadowing (e.g., transparency, reflection, ambient illumination, emissive illumination, nonShadowCastingLights). Transparent objects are assumed to render additively (but should set the blend mode themselves). Restore all state to the original form on exit. Default implementation invokes render. Implementation must obey the current stencil, depth write, color write, and depth test modes. Implementation may freely set the blending, and alpha test modes. The caller should invoke this in depth sorted back to front order for transparent objects. The default implementation configures the non-shadow casting lights and calls render. Implementation advice:
Render illumination from this light source additively. Implementation must set the alpha blending mode to additive. Must obey the current stencil, depth write, and depth test modes. Default implementation enables a single light and calls render.
Render illumination from this source additively, held out by the shadow map (which the caller must have computed, probably using renderNonShadowed). Default implementation configures the shadow map in texture unit 1 and calls render.
Sends all geometry including texture coordinates (uploading it first if necessary) but does not set any render device state or use any textures. This is useful when applying your own G3D::Shader to an existing PosedModel. Reimplemented in G3D::MD2Model::PosedMD2Model.
Sorts the array in place along the look vector from front-to-back.
Divides the inModels into a front-to-back sorted array of opaque models and a back-to-front sorted array of potentially transparent models. Any data originally in the output arrays is cleared.
If this model has texture coordinates, returns per-vertex texture coordinates in an array indexed the same as vertices() and geometry.vertexArray, otherwise returns an array of size zero. Default implementation returns an array of size zero. Reimplemented in G3D::MD2Model::PosedMD2Model.
Indices into the Geometry that create triangles. May be welded or not, depending on the model. Implemented in G3D::MD2Model::PosedMD2Model.
Implemented in G3D::MD2Model::PosedMD2Model.
Implemented in G3D::MD2Model::PosedMD2Model.
Contain adjacency information that merges colocated vertices (see MeshAlg::weldAdjacency).
Implemented in G3D::MD2Model::PosedMD2Model.
Implemented in G3D::MD2Model::PosedMD2Model.
Member Data DocumentationThe long name is to keep this from accidentally conflicting with a subclass's variable name. Do not use or explicitly manipulate this value--its type may change in the future and is not part of the supported API. Linked list of all weak pointers that reference this (some may be on the stack!). Do not use or explicitly manipulate this value.
The documentation for this class was generated from the following file: Generated on Thu Aug 2 11:40:47 2007 for G3D by 
1.5.2
Hosted by | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||