Model Class Reference

#include <model.h>

List of all members.

Public Member Functions
uint32	addMaterial (const Mesh::Material *)
uint32	addMesh (Mesh *)
const Mesh::Material *	getMaterial (uint32) const
Mesh *	getMesh (uint32) const
	Model ()
void	normalize (const Vec3f &centerOffset)
bool	pick (const Ray3d &r, double &distance) const
void	render (RenderContext &)
	Render the model in the current OpenGL context.
void	sortMeshes (const MeshComparator &)
bool	usesTextureType (Mesh::TextureSemantic) const
	~Model ()
Private Attributes
std::vector< const Mesh::Material * >	materials
std::vector< Mesh * >	meshes
bool	textureUsage [Mesh::TextureSemanticMax]
Classes
class	MeshComparator
class	OpacityComparator

---

Detailed Description

Model is the standard geometry object in Celestia. A Model consists of a library of materials together with a list of meshes. Each mesh object contains a pool of vertices and a set of primitive groups. A primitive groups consists of a a primitive group type and a list of vertex indices. This structure is exactly the one used in Celestia model (.cmod) files.

Definition at line 24 of file model.h.

---

Constructor & Destructor Documentation

Model::Model (   )

Definition at line 41 of file model.cpp. References textureUsage. { for (int i = 0; i < Mesh::TextureSemanticMax; i++) textureUsage[i] = false; }

Model::~Model (   )

Definition at line 48 of file model.cpp. References materials, and meshes. { { for (vector<Mesh*>::iterator iter = meshes.begin(); iter != meshes.end(); iter++) delete *iter; } #if 0 { for (vector<const Mesh::Material*>::iterator iter = materials.begin(); iter != materials.end(); iter++) delete *iter; } #endif }

---

Member Function Documentation

uint32 Model::addMaterial (  const Mesh::Material *   )

Add a new material to the model's material library; the return value is the number of materials in the model. Definition at line 77 of file model.cpp. References InvalidResource, materials, and textureUsage. Referenced by Convert3DSModel(), BinaryModelLoader::load(), AsciiModelLoader::load(), main(), and mergeModelMeshes(). { // Update the texture map usage information for the model. Since // the material being added isn't necessarily used by a mesh within // the model, we could potentially end up with false positives--this // won't cause any rendering troubles, but could hurt performance // if it forces multipass rendering when it's not required. for (int i = 0; i < Mesh::TextureSemanticMax; i++) { if (m->maps[i] != InvalidResource) textureUsage[i] = true; } materials.push_back(m); return materials.size(); }

uint32 Model::addMesh (  Mesh *   )

Add a new mesh to the model; the return value is the total number of meshes in the model. Definition at line 106 of file model.cpp. References meshes. Referenced by Convert3DSModel(), BinaryModelLoader::load(), AsciiModelLoader::load(), LoadCelestiaMesh(), main(), and mergeModelMeshes(). { meshes.push_back(m); return meshes.size(); }

const Mesh::Material * Model::getMaterial (  uint32   )  const

Return the material with the specified index, or NULL if the index is out of range. Definition at line 67 of file model.cpp. References materials. Referenced by Model::OpacityComparator::getOpacity(), and main(). { if (index < materials.size()) return materials[index]; else return NULL; }

Mesh * Model::getMesh (  uint32   )  const

Return the mesh with the specified index, or NULL if the index is out of range. Definition at line 96 of file model.cpp. References meshes. Referenced by main(). { if (index < meshes.size()) return meshes[index]; else return NULL; }

void Model::normalize (  const Vec3f &  centerOffset  )

Apply a uniform scale to the model so that it fits into a box with a center at centerOffset and a maximum side length of one. Definition at line 151 of file model.cpp. References AxisAlignedBox::getCenter(), AxisAlignedBox::getExtents(), AxisAlignedBox::include(), meshes, Vector3< T >::x, Vector3< T >::y, and Vector3< T >::z. Referenced by ModelInfo::load(). { AxisAlignedBox bbox; vector<Mesh*>::const_iterator iter; for (iter = meshes.begin(); iter != meshes.end(); iter++) bbox.include((*iter)->getBoundingBox()); Point3f center = bbox.getCenter() + centerOffset; Vec3f extents = bbox.getExtents(); float maxExtent = extents.x; if (extents.y > maxExtent) maxExtent = extents.y; if (extents.z > maxExtent) maxExtent = extents.z; for (iter = meshes.begin(); iter != meshes.end(); iter++) (*iter)->transform(Point3f(0, 0, 0) - center, 2.0f / maxExtent); #if 0 for (i = vertexLists.begin(); i != vertexLists.end(); i++) (*i)->transform(Point3f(0, 0, 0) - center, 2.0f / maxExtent); #endif }

bool Model::pick (  const Ray3d &  r, double &  distance )  const

Find the closest intersection between the ray and the model. If the ray intersects the model, return true and set distance; otherwise return false and leave distance unmodified. Definition at line 114 of file model.cpp. References distance(), and meshes. Referenced by Body::computeLocations(), and ExactPlanetPickTraversal(). { double maxDistance = 1.0e30; double closest = maxDistance; for (vector<Mesh*>::const_iterator iter = meshes.begin(); iter != meshes.end(); iter++) { double d = maxDistance; if ((*iter)->pick(r, d) && d < closest) closest = d; } if (closest != maxDistance) { distance = closest; return true; } else { return false; } }

void Model::render (  RenderContext &   )

Render the model in the current OpenGL context. Definition at line 140 of file model.cpp. References materials, meshes, and Mesh::render(). Referenced by Nebula::render(). { for (vector<Mesh*>::const_iterator iter = meshes.begin(); iter != meshes.end(); iter++) { (*iter)->render(materials, rc); } }

void Model::sortMeshes (  const MeshComparator &   )

Sort the model's meshes in place. Definition at line 235 of file model.cpp. References meshes. Referenced by ModelInfo::load(). { sort(meshes.begin(), meshes.end(), MeshComparatorAdapter(comparator)); }

bool Model::usesTextureType (  Mesh::TextureSemantic   )  const

Return true if the specified texture map type is used at all within a mesh. This information is used to decide if multiple rendering passes are required. Definition at line 178 of file model.cpp. References textureUsage. { return textureUsage[static_cast<int>(t)]; }

---

Member Data Documentation

std::vector<const Mesh::Material*> Model::materials [private]

Definition at line 104 of file model.h. Referenced by addMaterial(), getMaterial(), render(), and ~Model().

std::vector<Mesh*> Model::meshes [private]

Definition at line 105 of file model.h. Referenced by addMesh(), getMesh(), normalize(), pick(), render(), sortMeshes(), and ~Model().

bool Model::textureUsage[Mesh::TextureSemanticMax] [private]

Definition at line 107 of file model.h. Referenced by addMaterial(), Model(), and usesTextureType().

---

The documentation for this class was generated from the following files:

• src/celengine/model.h
• src/celengine/model.cpp

---