OOMesh Class Reference

#include <OOMesh.h>

Inheritance diagram for OOMesh:

Collaboration diagram for OOMesh:

Instance Methods
(NSString *)	- modelName
(void)	- rebindMaterials
(NSDictionary *)	- materials
(NSDictionary *)	- shaders
(size_t)	- vertexCount
(size_t)	- faceCount
(Octree *)	- octree
(BoundingBox)	- findBoundingBoxRelativeToPosition:basis:ri:rj:selfPosition:selfBasis:si:sj:
(BoundingBox)	- findSubentityBoundingBoxWithPosition:rotMatrix:
(OOMesh *)	- meshRescaledBy:
(id)	- init [implementation]
(void)	- dealloc [implementation]
(NSString *)	- descriptionComponents [implementation]
(id)	- copyWithZone: [implementation]
(void)	- renderOpaqueParts [implementation]
(BOOL)	- hasOpaqueParts [implementation]
(unsigned)	- octreeDepth [implementation]
(void)	- setBindingTarget: [implementation]
(void)	- dumpSelfState [implementation]
(NSSet *)	- allTextures [implementation]
(size_t)	- totalSize [implementation]
(BOOL)	- suppressClangStuff [implementation]
(id)	- initWithName:cacheKey:materialDictionary:shadersDictionary:smooth:shaderMacros:shaderBindingTarget:scaleFactor:cacheWriteable: [implementation]
(BOOL)	- loadData:scaleFactor: [implementation]
(void)	- checkNormalsAndAdjustWinding [implementation]
(void)	- generateFaceTangents [implementation]
(void)	- calculateVertexNormalsAndTangentsWithFaceRefs: [implementation]
(void)	- calculateVertexTangentsWithFaceRefs: [implementation]
(void)	- deleteDisplayLists [implementation]
(NSDictionary *)	- modelData [implementation]
(BOOL)	- setModelFromModelData:name: [implementation]
(void)	- getNormal:andTangent:forVertex:inSmoothGroup: [implementation]
(BOOL)	- setUpVertexArrays [implementation]
(void)	- calculateBoundingVolumes [implementation]
(void)	- rescaleByFactor: [implementation]
(void)	- debugDrawNormals [implementation]
(void)	- setRetainedObject:forKey: [implementation]
(void *)	- allocateBytesWithSize:count:key: [implementation]
(BOOL)	- allocateVertexBuffersWithCount: [implementation]
(BOOL)	- allocateNormalBuffersWithCount: [implementation]
(BOOL)	- allocateFaceBuffersWithCount: [implementation]
(BOOL)	- allocateVertexArrayBuffersWithCount: [implementation]
(void)	- renameTexturesFrom:to: [implementation]
(id)	- mutableCopyWithZone: [implementation]
(void)	- resetGraphicsState [implementation]
Instance Methods inherited from OODrawable
(void)	- renderTranslucentParts
(BOOL)	- hasTranslucentParts
(GLfloat)	- collisionRadius
(GLfloat)	- maxDrawDistance
(BoundingBox)	- boundingBox

Class Methods
(instancetype)	+ meshWithName:cacheKey:materialDictionary:shadersDictionary:smooth:shaderMacros:shaderBindingTarget:
(instancetype)	+ meshWithName:cacheKey:materialDictionary:shadersDictionary:smooth:shaderMacros:shaderBindingTarget:scaleFactor:cacheWriteable:
(OOMaterial *)	+ placeholderMaterial
(static NSString *)	+ NormalModeDescription [implementation]
(static float)	+ FaceArea [implementation]
(static float)	+ FaceAreaCorrect [implementation]

Private Attributes
uint8_t	_normalMode: 2
uint8_t	brokenInRender: 1
uint8_t	listsReady: 1
OOMeshMaterialCount	materialCount
OOMeshVertexCount	vertexCount
OOMeshFaceCount	faceCount
NSString *	baseFile
NSString *	baseFileOctreeCacheRef
BOOL	_cacheWriteable
Vector *	_vertices
Vector *	_normals
Vector *	_tangents
OOMeshFace *	_faces
OOMeshDisplayLists	_displayLists
NSRange	triangle_range [kOOMeshMaxMaterials]
NSString *	materialKeys [kOOMeshMaxMaterials]
OOMaterial *	materials [kOOMeshMaxMaterials]
GLuint	displayList0
GLfloat	collisionRadius
GLfloat	maxDrawDistance
BoundingBox	boundingBox
Octree *	octree
NSMutableDictionary *	_retainedObjects
NSDictionary *	_materialDict
NSDictionary *	_shadersDict
NSString *	_cacheKey
NSDictionary *	_shaderMacros
id	_shaderBindingTarget
Vector	_lastPosition
OOMatrix	_lastRotMatrix
BoundingBox	_lastBoundingBox

Detailed Description

Definition at line 89 of file OOMesh.h.

Method Documentation

allocateBytesWithSize:count:key:

- (void *) allocateBytesWithSize: (size_t) size count: (NSUInteger) count key: (NSString *) key

implementation

Provided by category OOMesh(Private).

Definition at line 2141 of file OOMesh.m.

                                :(size_t)size count:(NSUInteger)count key:(NSString *)key
{
    if (count == 0) { count=1; }
    size *= count;
    void *bytes = malloc(size);
    if (bytes != NULL)
    {
        Scribble(bytes, size);
        NSData *holder = [NSData dataWithBytesNoCopy:bytes length:size freeWhenDone:YES];
        [self setRetainedObject:holder forKey:key];
    }
    return bytes;
}

Referenced by OOMesh(Private)::allocateFaceBuffersWithCount:, OOMesh(Private)::allocateNormalBuffersWithCount:, OOMesh(Private)::allocateVertexArrayBuffersWithCount:, and OOMesh(Private)::allocateVertexBuffersWithCount:.

Here is the caller graph for this function:

allocateFaceBuffersWithCount:

- (BOOL) allocateFaceBuffersWithCount: (NSUInteger) count

implementation

Provided by category OOMesh(Private).

Definition at line 2171 of file OOMesh.m.

                                     :(NSUInteger)count
{
    _faces = [self allocateBytesWithSize:sizeof *_faces count:faceCount key:@"faces"];
    return  _faces != NULL;
}

allocateNormalBuffersWithCount:

- (BOOL) allocateNormalBuffersWithCount: (NSUInteger) count

implementation

Provided by category OOMesh(Private).

Definition at line 2163 of file OOMesh.m.

                                       :(NSUInteger)count
{
    _normals = [self allocateBytesWithSize:sizeof *_normals count:vertexCount key:@"normals"];
    _tangents = [self allocateBytesWithSize:sizeof *_tangents count:vertexCount key:@"tangents"];
    return _normals != NULL && _tangents != NULL;
}

allocateVertexArrayBuffersWithCount:

- (BOOL) allocateVertexArrayBuffersWithCount: (NSUInteger) count

implementation

Provided by category OOMesh(Private).

Definition at line 2178 of file OOMesh.m.

                                            :(NSUInteger)count
{
    _displayLists.indexArray = [self allocateBytesWithSize:sizeof *_displayLists.indexArray count:count * 3 key:@"indexArray"];
    _displayLists.textureUVArray = [self allocateBytesWithSize:sizeof *_displayLists.textureUVArray count:count * 6 key:@"textureUVArray"];
    _displayLists.vertexArray = [self allocateBytesWithSize:sizeof *_displayLists.vertexArray count:count * 3 key:@"vertexArray"];
    _displayLists.normalArray = [self allocateBytesWithSize:sizeof *_displayLists.normalArray count:count * 3 key:@"normalArray"];
    _displayLists.tangentArray = [self allocateBytesWithSize:sizeof *_displayLists.tangentArray count:count * 3 key:@"tangentArray"];
    
    return  _faces != NULL &&
            _displayLists.indexArray != NULL &&
            _displayLists.textureUVArray != NULL &&
            _displayLists.vertexArray != NULL &&
            _displayLists.normalArray != NULL &&
            _displayLists.tangentArray != NULL;
}

allocateVertexBuffersWithCount:

- (BOOL) allocateVertexBuffersWithCount: (NSUInteger) count

implementation

Provided by category OOMesh(Private).

Definition at line 2156 of file OOMesh.m.

                                       :(NSUInteger)count
{
    _vertices = [self allocateBytesWithSize:sizeof *_vertices count:vertexCount key:@"vertices"];
    return _vertices != NULL;
}

allTextures

- (NSSet *) allTextures

implementation

Reimplemented from OODrawable.

Definition at line 823 of file OOMesh.m.

{
    NSMutableSet *result = [NSMutableSet set];
    OOMeshMaterialCount i;
    for (i = 0; i != materialCount; i++)
    {
        [result unionSet:[materials[i] allTextures]];
    }
    
    return result;
}

References OOMaterial::allTextures, allTextures, and materialCount.

Referenced by allTextures.

Here is the call graph for this function:

Here is the caller graph for this function:

calculateBoundingVolumes

- (void) calculateBoundingVolumes

implementation

Provided by category OOMesh(Private).

Definition at line 1982 of file OOMesh.m.

{
    OOJS_PROFILE_ENTER
    
    OOMeshVertexCount  i;
    float               d_squared, length_longest_axis, length_shortest_axis;
    GLfloat             result;
    
    result = 0.0f;
    if (vertexCount)  bounding_box_reset_to_vector(&boundingBox, _vertices[0]);
    else  bounding_box_reset(&boundingBox);
 
    for (i = 0; i < vertexCount; i++)
    {
        d_squared = magnitude2(_vertices[i]);
        if (d_squared > result)  result = d_squared;
        bounding_box_add_vector(&boundingBox, _vertices[i]);
    }
 
    length_longest_axis = boundingBox.max.x - boundingBox.min.x;
    if (boundingBox.max.y - boundingBox.min.y > length_longest_axis)
        length_longest_axis = boundingBox.max.y - boundingBox.min.y;
    if (boundingBox.max.z - boundingBox.min.z > length_longest_axis)
        length_longest_axis = boundingBox.max.z - boundingBox.min.z;
 
    length_shortest_axis = boundingBox.max.x - boundingBox.min.x;
    if (boundingBox.max.y - boundingBox.min.y < length_shortest_axis)
        length_shortest_axis = boundingBox.max.y - boundingBox.min.y;
    if (boundingBox.max.z - boundingBox.min.z < length_shortest_axis)
        length_shortest_axis = boundingBox.max.z - boundingBox.min.z;
 
    d_squared = (length_longest_axis + length_shortest_axis) * (length_longest_axis + length_shortest_axis) * 0.25; // square of average length
    maxDrawDistance = d_squared * NO_DRAW_DISTANCE_FACTOR * NO_DRAW_DISTANCE_FACTOR;   // no longer based on the collision radius
    
    collisionRadius = sqrtf(result);
    
    OOJS_PROFILE_EXIT_VOID
}

Referenced by OOMesh(Private)::initWithName:cacheKey:materialDictionary:shadersDictionary:smooth:shaderMacros:shaderBindingTarget:scaleFactor:cacheWriteable:, OOMesh(Private)::loadData:scaleFactor:, and OOMesh(Private)::rescaleByFactor:.

Here is the caller graph for this function:

calculateVertexNormalsAndTangentsWithFaceRefs:

- (void) calculateVertexNormalsAndTangentsWithFaceRefs: (VertexFaceRef *) faceRefs

implementation

Provided by category OOMesh(Private).

Definition at line 1749 of file OOMesh.m.

                                                      :(VertexFaceRef *)faceRefs
{
    OOJS_PROFILE_ENTER
    
    NSParameterAssert(faceRefs != NULL);
    
    NSUInteger  i,j;
    float       triangle_area[faceCount];
    
    NSAssert1(_normals != NULL && _tangents != NULL, @"Normal/tangent buffers not allocated in %s", __PRETTY_FUNCTION__);
    
    for (i = 0 ; i < faceCount; i++)
    {
        triangle_area[i] = FaceArea(_faces[i].vertex, _vertices);
    }
    for (i = 0; i < vertexCount; i++)
    {
        Vector normal_sum = kZeroVector;
        Vector tangent_sum = kZeroVector;
        
        VertexFaceRef *vfr = &faceRefs[i];
        NSUInteger fIter, fCount = VFRGetCount(vfr);
        for (fIter = 0; fIter < fCount; fIter++)
        {
            j = VFRGetFaceAtIndex(vfr, fIter);
            
            float t = triangle_area[j]; // weight sum by area
            normal_sum = vector_add(normal_sum, vector_multiply_scalar(_faces[j].normal, t));
            tangent_sum = vector_add(tangent_sum, vector_multiply_scalar(_faces[j].tangent, t));
        }
        
        normal_sum = vector_normal_or_fallback(normal_sum, kBasisZVector);
        tangent_sum = vector_subtract(tangent_sum, vector_multiply_scalar(normal_sum, dot_product(tangent_sum, normal_sum)));
        tangent_sum = vector_normal_or_fallback(tangent_sum, kBasisXVector);
        
        _normals[i] = normal_sum;
        _tangents[i] = tangent_sum;
    }
    
    OOJS_PROFILE_EXIT_VOID
}

Referenced by OOMesh(Private)::loadData:scaleFactor:.

Here is the caller graph for this function:

calculateVertexTangentsWithFaceRefs:

- (void) calculateVertexTangentsWithFaceRefs: (VertexFaceRef *) faceRefs

implementation

Provided by category OOMesh(Private).

Definition at line 1808 of file OOMesh.m.

                                            :(VertexFaceRef *)faceRefs
{
    OOJS_PROFILE_ENTER
    
    NSParameterAssert(faceRefs != NULL);
    
    /*  This is conceptually broken.
        At the moment, it's calculating one tangent per "input" vertex. It should
        be calculating one tangent per "real" vertex, where a "real" vertex is
        defined as a combination of position, normal, material and texture
        coordinates.
        Currently, we don't have a format with unique "real" vertices.
        This basically means explicit-normal models without explicit tangents
        can't usefully be normal mapped.
        I don't intend to do anything about this pre-MSNR, although it might be
        possible to fix it by moving tangent generation to the same stage as
        smooth-grouped normal generation.
        -- Ahruman 2010-05-22
    */
    NSUInteger  i,j;
    float   triangle_area[faceCount];
    for (i = 0 ; i < faceCount; i++)
    {
        triangle_area[i] = FaceAreaCorrect(_faces[i].vertex, _vertices);
    }
    for (i = 0; i < vertexCount; i++)
    {
        Vector tangent_sum = kZeroVector;
        
        VertexFaceRef *vfr = &faceRefs[i];
        NSUInteger fIter, fCount = VFRGetCount(vfr);
        for (fIter = 0; fIter < fCount; fIter++)
        {
            j = VFRGetFaceAtIndex(vfr, fIter);
            
            float t = triangle_area[j]; // weight sum by area
            tangent_sum = vector_add(tangent_sum, vector_multiply_scalar(_faces[j].tangent, t));
        }
        
        tangent_sum = vector_subtract(tangent_sum, vector_multiply_scalar(_normals[i], dot_product(_normals[i], tangent_sum)));
        tangent_sum = vector_normal_or_fallback(tangent_sum, kBasisXVector);
        
        _tangents[i] = tangent_sum;
    }
    
    OOJS_PROFILE_EXIT_VOID
}

Referenced by OOMesh(Private)::loadData:scaleFactor:.

Here is the caller graph for this function:

checkNormalsAndAdjustWinding

- (void) checkNormalsAndAdjustWinding

implementation

Provided by category OOMesh(Private).

Definition at line 1647 of file OOMesh.m.

{
    OOJS_PROFILE_ENTER
    
    Vector              calculatedNormal;
    OOMeshFaceCount      i;
    
    NSParameterAssert(_normalMode != kNormalModeExplicit);
    
    for (i = 0; i < faceCount; i++)
    {
        Vector v0, v1, v2, norm;
        v0 = _vertices[_faces[i].vertex[0]];
        v1 = _vertices[_faces[i].vertex[1]];
        v2 = _vertices[_faces[i].vertex[2]];
        norm = _faces[i].normal;
        
        calculatedNormal = normal_to_surface(v2, v1, v0);
        if (vector_equal(norm, kZeroVector))
        {
            norm = vector_flip(calculatedNormal);
            _faces[i].normal = norm;
        }
        
        /*  FIXME: for 2.0, either require explicit normals for every model
            or change to: if (dot_product(norm, calculatedNormal) < 0.0f)
            -- Ahruman 2010-01-23
        */
        if (norm.x * calculatedNormal.x < 0 || norm.y * calculatedNormal.y < 0 || norm.z * calculatedNormal.z < 0)
        {
            // normal lies in the WRONG direction!
            // reverse the winding
            int v0 = _faces[i].vertex[0];
            _faces[i].vertex[0] = _faces[i].vertex[2];
            _faces[i].vertex[2] = v0;
            
            GLfloat f0 = _faces[i].s[0];
            _faces[i].s[0] = _faces[i].s[2];
            _faces[i].s[2] = f0;
            
            f0 = _faces[i].t[0];
            _faces[i].t[0] = _faces[i].t[2];
            _faces[i].t[2] = f0;
        }
    }
    
    OOJS_PROFILE_EXIT_VOID
}

Referenced by OOMesh(Private)::loadData:scaleFactor:.

Here is the caller graph for this function:

copyWithZone:

- (id) copyWithZone: (NSZone *) zone

implementation

Definition at line 360 of file OOMesh.m.

                  :(NSZone *)zone
{
    if (zone == [self zone])  return [self retain]; // OK because we're immutable seen from the outside
    else  return [self mutableCopyWithZone:zone];
}

References mutableCopyWithZone:.

Here is the call graph for this function:

dealloc

- (void) dealloc

implementation

Definition at line 307 of file OOMesh.m.

{
    unsigned                i;
    
    DESTROY(baseFileOctreeCacheRef);
    DESTROY(baseFile);
    DESTROY(octree);
    
    [self deleteDisplayLists];
    
    for (i = 0; i != kOOMeshMaxMaterials; ++i)
    {
        DESTROY(materials[i]);
        DESTROY(materialKeys[i]);
    }
    
    [[OOGraphicsResetManager sharedManager] unregisterClient:self];
    
    DESTROY(_retainedObjects);
    
    DESTROY(_materialDict);
    DESTROY(_shadersDict);
    DESTROY(_cacheKey);
    DESTROY(_shaderMacros);
    DESTROY(_shaderBindingTarget);
    
#if OOMESH_PROFILE
    DESTROY(_stopwatch);
#endif
    
    [super dealloc];
}

References _cacheKey, _materialDict, _retainedObjects, _shaderBindingTarget, _shaderMacros, _shadersDict, baseFile, baseFileOctreeCacheRef, dealloc, deleteDisplayLists, DESTROY, kOOMeshMaxMaterials, materialKeys, materials, octree, OOGraphicsResetManager::sharedManager, and OOGraphicsResetManager::unregisterClient:.

Referenced by dealloc.

Here is the call graph for this function:

Here is the caller graph for this function:

debugDrawNormals

- (void) debugDrawNormals

implementation

Provided by category OOMesh(Private).

Definition at line 2055 of file OOMesh.m.

{
    GLuint              i;
    Vector              v, n, t, b;
    float               length, blend;
    GLfloat             color[3];
    OODebugWFState      state;
    
    OO_ENTER_OPENGL();
    
    state = OODebugBeginWireframe(NO);
    
    // Draw
    OOGLBEGIN(GL_LINES);
    for (i = 0; i < _displayLists.count; ++i)
    {
        v = _displayLists.vertexArray[i];
        n = _displayLists.normalArray[i];
        t = _displayLists.tangentArray[i];
        b = true_cross_product(n, t);
        
        // Draw normal
        length = magnitude2(n);
        blend = fabs(length - 1) * 5.0;
        color[0] = MIN(blend, 1.0f);
        color[1] = 1.0f - color[0];
        color[2] = color[1];
        glColor3fv(color);
        
        glVertex3f(v.x, v.y, v.z);
        scale_vector(&n, 5.0f);
        n = vector_add(n, v);
        glVertex3f(n.x, n.y, n.z);
        
        // Draw tangent
        glColor3f(1.0f, 1.0f, 0.0f);
        t = vector_add(v, vector_multiply_scalar(t, 3.0f));
        glVertex3f(v.x, v.y, v.z);
        glVertex3f(t.x, t.y, t.z);
        
        // Draw bitangent
        glColor3f(0.0f, 1.0f, 0.0f);
        b = vector_add(v, vector_multiply_scalar(b, 3.0f));
        glVertex3f(v.x, v.y, v.z);
        glVertex3f(b.x, b.y, b.z);
    }
    OOGLEND();
    
    OODebugEndWireframe(state);
}

Referenced by renderOpaqueParts.

Here is the caller graph for this function:

deleteDisplayLists

- (void) deleteDisplayLists

implementation

Provided by category OOMesh(Private).

Definition at line 976 of file OOMesh.m.

{
    if (listsReady)
    {
        OO_ENTER_OPENGL();
        
        OOGL(glDeleteLists(displayList0, materialCount));
        listsReady = NO;
    }
}

Referenced by dealloc, and OOMesh(Private)::resetGraphicsState.

Here is the caller graph for this function:

descriptionComponents

- (NSString *) descriptionComponents

implementation

Definition at line 354 of file OOMesh.m.

{
    return [NSString stringWithFormat:@"\"%@\", %zu vertices, %zu faces, radius: %g m normals: %@", [self modelName], [self vertexCount], [self faceCount], [self collisionRadius], NormalModeDescription(_normalMode)];
}

References collisionRadius, descriptionComponents, faceCount, modelName, and vertexCount.

Referenced by descriptionComponents.

Here is the call graph for this function:

Here is the caller graph for this function:

dumpSelfState

- (void) dumpSelfState

implementation

Reimplemented from OODrawable.

Definition at line 811 of file OOMesh.m.

{
    [super dumpSelfState];
    
    if (baseFile != nil)  OOLog(@"dumpState.mesh", @"Model file: %@", baseFile);
    OOLog(@"dumpState.mesh", @"Vertex count: %u, face count: %u", vertexCount, faceCount);
    OOLog(@"dumpState.mesh", @"Normals: %@", NormalModeDescription(_normalMode));
}

References _normalMode, baseFile, OODrawable::dumpSelfState, dumpSelfState, faceCount, nil, NormalModeDescription, OOLog, and vertexCount.

Referenced by dumpSelfState.

Here is the call graph for this function:

Here is the caller graph for this function:

FaceArea

+ (static float) FaceArea (GLuint *) vertIndices (Vector *) vertices

implementation

Provided by category OOMesh(Private).

Definition at line 1739 of file OOMesh.m.

{
    /*  Calculate areas using Heron's formula.  */
    float   a2 = distance2(vertices[vertIndices[0]], vertices[vertIndices[1]]);
    float   b2 = distance2(vertices[vertIndices[1]], vertices[vertIndices[2]]);
    float   c2 = distance2(vertices[vertIndices[2]], vertices[vertIndices[0]]);
    return sqrt((2.0f * (a2 * b2 + b2 * c2 + c2 * a2) - (a2 * a2 + b2 * b2 +c2 * c2)) * 0.0625f);
}

FaceAreaCorrect

+ (static float) FaceAreaCorrect (GLuint *) vertIndices (Vector *) vertices

implementation

Provided by category OOMesh(Private).

Definition at line 1792 of file OOMesh.m.

{
    /*  Calculate area of triangle.
        The magnitude of the cross product of two vectors is the area of
        the parallelogram they span. The area of a triangle is half the
        area of a parallelogram sharing two of its sides.
        Since we only use the area of the triangle as a weight factor,
        constant terms are irrelevant, so we don't bother halving the
        value.
    */
    Vector AB = vector_subtract(vertices[vertIndices[1]], vertices[vertIndices[0]]);
    Vector AC = vector_subtract(vertices[vertIndices[2]], vertices[vertIndices[0]]);
    return magnitude(true_cross_product(AB, AC));
}

faceCount

- (size_t) faceCount

References octree.

findBoundingBoxRelativeToPosition:basis:ri:rj:selfPosition:selfBasis:si:sj:

- (BoundingBox) findBoundingBoxRelativeToPosition:		(Vector)	opv
basis:		(Vector)
ri:		(Vector)
rj:		(Vector)	rk
selfPosition:		(Vector)	position
selfBasis:		(Vector)
si:		(Vector)
sj:		(Vector)	sk

Definition at line 712 of file OOMesh.m.

                                                 :(Vector)opv
                                            basis:(Vector)ri :(Vector)rj :(Vector)rk
                                     selfPosition:(Vector)position
                                        selfBasis:(Vector)si :(Vector)sj :(Vector)sk
{
    BoundingBox result;
    Vector      pv, rv;
    
    // FIXME: rewrite with matrices
    Vector rpos = vector_subtract(position, opv);   // model origin relative to opv
    
    rv.x = dot_product(ri,rpos);
    rv.y = dot_product(rj,rpos);
    rv.z = dot_product(rk,rpos);    // model origin rel to opv in ijk
    
    if (EXPECT_NOT(vertexCount < 1))
    {
        bounding_box_reset_to_vector(&result, rv);
    }
    else
    {
        pv.x = rpos.x + si.x * _vertices[0].x + sj.x * _vertices[0].y + sk.x * _vertices[0].z;
        pv.y = rpos.y + si.y * _vertices[0].x + sj.y * _vertices[0].y + sk.y * _vertices[0].z;
        pv.z = rpos.z + si.z * _vertices[0].x + sj.z * _vertices[0].y + sk.z * _vertices[0].z; // _vertices[0] position rel to opv
        rv.x = dot_product(ri, pv);
        rv.y = dot_product(rj, pv);
        rv.z = dot_product(rk, pv); // _vertices[0] position rel to opv in ijk
        bounding_box_reset_to_vector(&result, rv);
    }
    
    OOMeshVertexCount i;
    for (i = 1; i < vertexCount; i++)
    {
        pv.x = rpos.x + si.x * _vertices[i].x + sj.x * _vertices[i].y + sk.x * _vertices[i].z;
        pv.y = rpos.y + si.y * _vertices[i].x + sj.y * _vertices[i].y + sk.y * _vertices[i].z;
        pv.z = rpos.z + si.z * _vertices[i].x + sj.z * _vertices[i].y + sk.z * _vertices[i].z;
        rv.x = dot_product(ri, pv);
        rv.y = dot_product(rj, pv);
        rv.z = dot_product(rk, pv);
        bounding_box_add_vector(&result, rv);
    }
 
    return result;
}

References _vertices, EXPECT_NOT, and vertexCount.

findSubentityBoundingBoxWithPosition:rotMatrix:

- (BoundingBox) findSubentityBoundingBoxWithPosition:		(Vector)	position
rotMatrix:		(OOMatrix)	rotMatrix

Definition at line 758 of file OOMesh.m.

                                                   :(Vector)position rotMatrix:(OOMatrix)rotMatrix
{
    // HACK! Should work out what the various bounding box things do and make it neat and consistent.
    // FIXME: this is a bottleneck.
// Try to fix bottleneck by caching for common case where subentity
// pos+rot is constant from frame to frame. - CIM
 
    if (vector_equal(position,_lastPosition) && OOMatrixEqual(rotMatrix,_lastRotMatrix))
    {
        return _lastBoundingBox;
    }
 
    BoundingBox     result;
    Vector          v;
    
    v = vector_add(position, OOVectorMultiplyMatrix(_vertices[0], rotMatrix));
    bounding_box_reset_to_vector(&result,v);
    
    OOMeshVertexCount i;
    for (i = 1; i < vertexCount; i++)
    {
        v = vector_add(position, OOVectorMultiplyMatrix(_vertices[i], rotMatrix));
        bounding_box_add_vector(&result,v);
    }
    
    _lastBoundingBox = result;
    _lastPosition = position;
    _lastRotMatrix = rotMatrix;
 
    return result;
}

References _lastBoundingBox, _lastPosition, _lastRotMatrix, _vertices, OOMatrixEqual(), OOVectorMultiplyMatrix(), and vertexCount.

Referenced by ShipEntity::findSubentityBoundingBox.

Here is the call graph for this function:

Here is the caller graph for this function:

generateFaceTangents

- (void) generateFaceTangents

implementation

Provided by category OOMesh(Private).

Definition at line 1697 of file OOMesh.m.

{
    OOJS_PROFILE_ENTER
    
    OOMeshFaceCount  i;
    for (i = 0; i < faceCount; i++)
    {
        OOMeshFace *face = _faces + i;
        
        /*  Generate tangents, i.e. vectors that run in the direction of the s
            texture coordinate. Based on code I found in a forum somewhere and
            then lost track of. Sorry to whomever I should be crediting.
            -- Ahruman 2008-11-23
        */
        Vector vAB = vector_subtract(_vertices[face->vertex[1]], _vertices[face->vertex[0]]);
        Vector vAC = vector_subtract(_vertices[face->vertex[2]], _vertices[face->vertex[0]]);
        Vector nA = face->normal;
        
        // projAB = aB - (nA . vAB) * nA
        Vector vProjAB = vector_subtract(vAB, vector_multiply_scalar(nA, dot_product(nA, vAB)));
        Vector vProjAC = vector_subtract(vAC, vector_multiply_scalar(nA, dot_product(nA, vAC)));
        
        // delta s/t
        GLfloat dsAB = face->s[1] - face->s[0];
        GLfloat dsAC = face->s[2] - face->s[0];
        GLfloat dtAB = face->t[1] - face->t[0];
        GLfloat dtAC = face->t[2] - face->t[0];
        
        if (dsAC * dtAB > dsAB * dtAC)
        {
            face->tangent = vector_normal(vector_subtract(vector_multiply_scalar(vProjAC, dtAB), vector_multiply_scalar(vProjAB, dtAC)));
        }
        else
        {
            face->tangent = vector_normal(vector_subtract(vector_multiply_scalar(vProjAB, dtAC), vector_multiply_scalar(vProjAC, dtAB)));
        }           
    }
    
    OOJS_PROFILE_EXIT_VOID
}

Referenced by OOMesh(Private)::loadData:scaleFactor:.

Here is the caller graph for this function:

getNormal:andTangent:forVertex:inSmoothGroup:

- (void) getNormal: (Vector *) outNormal andTangent: (Vector *) outTangent forVertex: (OOMeshVertexCount) v_index inSmoothGroup: (OOMeshSmoothGroup) smoothGroup

implementation

Provided by category OOMesh(Private).

Definition at line 1858 of file OOMesh.m.

                  :(Vector *)outNormal andTangent:(Vector *)outTangent forVertex:(OOMeshVertexCount)v_index inSmoothGroup:(OOMeshSmoothGroup)smoothGroup
{
    OOJS_PROFILE_ENTER
    
    assert(outNormal != NULL && outTangent != NULL);
    
    NSUInteger j;
    Vector normal_sum = kZeroVector;
    Vector tangent_sum = kZeroVector;
    for (j = 0; j < faceCount; j++)
    {
        if (_faces[j].smoothGroup == smoothGroup)
        {
            if ((_faces[j].vertex[0] == v_index)||(_faces[j].vertex[1] == v_index)||(_faces[j].vertex[2] == v_index))
            {
                float area = FaceArea(_faces[j].vertex, _vertices);
                normal_sum = vector_add(normal_sum, vector_multiply_scalar(_faces[j].normal, area));
                tangent_sum = vector_add(tangent_sum, vector_multiply_scalar(_faces[j].tangent, area));
            }
        }
    }
    
    *outNormal = vector_normal_or_fallback(normal_sum, kBasisZVector);
    *outTangent = vector_normal_or_fallback(tangent_sum, kBasisXVector);
    
    OOJS_PROFILE_EXIT_VOID
}

Referenced by OOMesh(Private)::setUpVertexArrays.

Here is the caller graph for this function:

hasOpaqueParts

- (BOOL) hasOpaqueParts

implementation

Reimplemented from OODrawable.

Definition at line 623 of file OOMesh.m.

{
    return YES;
}

References hasOpaqueParts.

Referenced by hasOpaqueParts.

Here is the call graph for this function:

Here is the caller graph for this function:

init

- (id) init

implementation

Definition at line 287 of file OOMesh.m.

{
    self = [super init];
    if (self == nil)  return nil;
    
    baseFile = @"No Model";
    baseFileOctreeCacheRef = @"No Model-0.000";
    _cacheWriteable = YES;
#if OO_MULTITEXTURE
    _textureUnitCount = NSNotFound;
#endif
 
    _lastPosition = kZeroVector;
    _lastRotMatrix = kZeroMatrix; // not identity
    _lastBoundingBox = kZeroBoundingBox;
 
    return self;
}

References _cacheWriteable, _lastBoundingBox, _lastPosition, _lastRotMatrix, baseFile, baseFileOctreeCacheRef, init, kZeroBoundingBox, kZeroMatrix, kZeroVector, and nil.

Referenced by init.

Here is the call graph for this function:

Here is the caller graph for this function:

initWithName:cacheKey:materialDictionary:shadersDictionary:smooth:shaderMacros:shaderBindingTarget:scaleFactor:cacheWriteable:

- (id) initWithName: (NSString *) name cacheKey: (NSString *) cacheKey materialDictionary: (NSDictionary *) materialDict shadersDictionary: (NSDictionary *) shadersDict smooth: (BOOL) smooth shaderMacros: (NSDictionary *) macros shaderBindingTarget: (id<OOWeakReferenceSupport>) object scaleFactor: (float) scale cacheWriteable: (BOOL) cacheWriteable

implementation

Provided by category OOMesh(Private).

Definition at line 873 of file OOMesh.m.

                  :(NSString *)name
          cacheKey:(NSString *)cacheKey
materialDictionary:(NSDictionary *)materialDict
 shadersDictionary:(NSDictionary *)shadersDict
            smooth:(BOOL)smooth
      shaderMacros:(NSDictionary *)macros
shaderBindingTarget:(id<OOWeakReferenceSupport>)target
       scaleFactor:(float)scale
    cacheWriteable:(BOOL)cacheWriteable
{
    OOJS_PROFILE_ENTER
    
    self = [super init];
    if (self == nil)  return nil;
    
    NSAutoreleasePool* pool = [[NSAutoreleasePool alloc] init];
    _normalMode = smooth ? kNormalModeSmooth : kNormalModePerFace;
    _cacheWriteable = cacheWriteable;
    
#if OOMESH_PROFILE
    _stopwatch = [[OOProfilingStopwatch alloc] init];
#endif
    
    if ([self loadData:name scaleFactor:scale])
    {
        [self calculateBoundingVolumes];
        PROFILE(@"finished calculateBoundingVolumes (again\?\?)");
        
        baseFile = [name copy];
        baseFileOctreeCacheRef = [[NSString stringWithFormat:@"%@-%.3f", baseFile, scale] copy];
        
        /*  New in r3033: save the material-defining parameters here so we
            can rebind the materials at any time.
            -- Ahruman 2010-02-17
        */
        _materialDict = [materialDict copy];
        _shadersDict = [shadersDict copy];
        _cacheKey = [cacheKey copy];
        _shaderMacros = [macros copy];
        _shaderBindingTarget = [target weakRetain];
        
        [self rebindMaterials];
        PROFILE(@"finished material setup");
        
        [[OOGraphicsResetManager sharedManager] registerClient:self];
    }
    else
    {
        [self release];
        self = nil;
    }
#if OOMESH_PROFILE
    DESTROY(_stopwatch);
#endif
#if OO_MULTITEXTURE
    if (EXPECT(self != nil))
    {
        _textureUnitCount = NSNotFound;
    }
#endif
    
    [pool release];
    return self;
    
    OOJS_PROFILE_EXIT
}

loadData:scaleFactor:

- (BOOL) loadData: (NSString *) filename scaleFactor: (float) scale

implementation

Provided by category OOMesh(Private).

Definition at line 1162 of file OOMesh.m.

                :(NSString *)filename scaleFactor:(float)scale
{
    OOJS_PROFILE_ENTER
    
    NSScanner           *scanner;
    NSDictionary        *cacheData = nil;
    BOOL                failFlag = NO;
    NSString            *failString = @"***** ";
    unsigned            i, j;
    NSMutableDictionary *texFileName2Idx = nil;
    NSString            *cacheKey = nil;
    BOOL                using_preloaded = NO;
    
    cacheKey = [NSString stringWithFormat:@"%@:%u:%.3f", filename, _normalMode, scale];
    cacheData = [OOCacheManager meshDataForName:cacheKey];
    if (cacheData != nil)
    {
        if ([self setModelFromModelData:cacheData name:filename])
        {
            using_preloaded = YES;
            PROFILE(@"loaded from cache");
            OOLog(@"mesh.load.cached", @"Retrieved mesh \"%@\" from cache.", filename);
        }
    }
    
    if (!using_preloaded)
    {
        OOLog(@"mesh.load.uncached", @"Mesh \"%@\" is not in cache, loading.", cacheKey);
        
        NSCharacterSet  *whitespaceCharSet = [NSCharacterSet whitespaceCharacterSet];
        NSCharacterSet  *whitespaceAndNewlineCharSet = [NSCharacterSet whitespaceAndNewlineCharacterSet];
#if OOLITE_MAC_OS_X
        NSCharacterSet  *newlineCharSet = [NSCharacterSet newlineCharacterSet];
#else
        static NSCharacterSet *newlineCharSet = nil;
        if (newlineCharSet == nil)
        {
            NSMutableCharacterSet *temp = [[whitespaceAndNewlineCharSet mutableCopy] autorelease];
            [temp formIntersectionWithCharacterSet:[whitespaceCharSet invertedSet]];
            newlineCharSet = [temp copy];
        }
#endif
        
        texFileName2Idx = [NSMutableDictionary dictionary];
        
        {
            NSAutoreleasePool* pool = [[NSAutoreleasePool alloc] init];
            NSString *data = [ResourceManager stringFromFilesNamed:filename inFolder:@"Models" cache:NO];
            if (data == nil)
            {
                // Model not found
                OOLog(kOOLogMeshDataNotFound, @"***** ERROR: could not find %@", filename);
                OOStandardsError(@"Model file not found");
                return NO;
            }
            
            // strip out comments and commas between values
            NSMutableArray *lines = [NSMutableArray arrayWithArray:[data componentsSeparatedByString:@"\n"]];
            for (i = 0; i < [lines count]; i++)
            {
                NSString *line = [lines objectAtIndex:i];
                NSArray *parts;
                //
                // comments
                //
                parts = [line componentsSeparatedByString:@"#"];
                line = [parts objectAtIndex:0];
                parts = [line componentsSeparatedByString:@"//"];
                line = [parts objectAtIndex:0];
                //
                // commas
                //
                line = [[line componentsSeparatedByString:@","] componentsJoinedByString:@" "];
                //
                [lines replaceObjectAtIndex:i withObject:line];
            }
            
            data = [lines componentsJoinedByString:@"\n"];
            scanner = [NSScanner scannerWithString:data];
            
            [scanner retain];
            [pool release];
            [scanner autorelease];
        }
        
        PROFILE(@"finished preprocessing");
 
        // get number of vertices
        //
        [scanner setScanLocation:0];    //reset
        if ([scanner scanString:@"NVERTS" intoString:NULL])
        {
            int n_v;
            if ([scanner scanInt:&n_v])
                vertexCount = n_v;
            else
            {
                failFlag = YES;
                failString = [NSString stringWithFormat:@"%@Failed to read value of NVERTS\n",failString];
            }
        }
        else
        {
            failFlag = YES;
            failString = [NSString stringWithFormat:@"%@Failed to read NVERTS\n",failString];
        }
        
        if (![self allocateVertexBuffersWithCount:vertexCount])
        {
            OOLog(kOOLogAllocationFailure, @"***** ERROR: failed to allocate memory for model %@ (%u vertices).", filename, vertexCount);
            return NO;
        }
        
        // get number of faces
        if ([scanner scanString:@"NFACES" intoString:NULL])
        {
            int n_f;
            if ([scanner scanInt:&n_f])
            {
                faceCount = n_f;
            }
            else
            {
                failFlag = YES;
                failString = [NSString stringWithFormat:@"%@Failed to read value of NFACES\n",failString];
            }
        }
        else
        {
            failFlag = YES;
            failString = [NSString stringWithFormat:@"%@Failed to read NFACES\n",failString];
        }
        
        // Allocate face->vertex table.
        size_t faceRefSize = sizeof (VertexFaceRef) * vertexCount;
        VertexFaceRef *faceRefs = calloc(1, faceRefSize);
        if (faceRefs != NULL)
        {
            // use an NSData to effectively autorelease it.
            NSData *faceRefHolder = [NSData dataWithBytesNoCopy:faceRefs length:faceRefSize freeWhenDone:YES];
            if (faceRefHolder == nil)
            {
                free(faceRefs);
                faceRefs = NULL;
            }
        }
        
        if (faceRefs == NULL || ![self allocateFaceBuffersWithCount:faceCount])
        {
            OOLog(kOOLogAllocationFailure, @"***** ERROR: failed to allocate memory for model %@ (%u vertices, %u faces).", filename, vertexCount, faceCount);
            return NO;
        }
        
        // get vertex data
        if ([scanner scanString:@"VERTEX" intoString:NULL])
        {
            for (j = 0; j < vertexCount; j++)
            {
                float x, y, z;
                if (!failFlag)
                {
                    if (![scanner scanFloat:&x])  failFlag = YES;
                    if (![scanner scanFloat:&y])  failFlag = YES;
                    if (![scanner scanFloat:&z])  failFlag = YES;
                    if (!failFlag)
                    {
                        _vertices[j] = make_vector(x*scale, y*scale, z*scale);
                    }
                    else
                    {
                        failString = [NSString stringWithFormat:@"%@Failed to read a value for vertex[%d] in %@\n", failString, j, @"VERTEX"];
                    }
                }
            }
        }
        else
        {
            failFlag = YES;
            failString = [NSString stringWithFormat:@"%@Failed to find VERTEX data\n",failString];
        }
 
        // get face data
        if ([scanner scanString:@"FACES" intoString:NULL])
        {
            for (j = 0; j < faceCount; j++)
            {
                int r, g, b;
                float nx, ny, nz;
                int n_v;
                if (!failFlag)
                {
                    // colors
                    if (![scanner scanInt:&r])  failFlag = YES;
                    if (![scanner scanInt:&g])  failFlag = YES;
                    if (![scanner scanInt:&b])  failFlag = YES;
                    if (!failFlag)
                    {
                        _faces[j].smoothGroup = r;
                    }
                    else
                    {
                        failString = [NSString stringWithFormat:@"%@Failed to read a color for face[%d] in FACES\n", failString, j];
                    }
                    
                    // normal
                    if (![scanner scanFloat:&nx])  failFlag = YES;
                    if (![scanner scanFloat:&ny])  failFlag = YES;
                    if (![scanner scanFloat:&nz])  failFlag = YES;
                    if (!failFlag)
                    {
                        _faces[j].normal = vector_normal(make_vector(nx, ny, nz));
                    }
                    else
                    {
                        failString = [NSString stringWithFormat:@"%@Failed to read a normal for face[%d] in FACES\n", failString, j];
                    }
                    
                    // vertices
                    if ([scanner scanInt:&n_v])
                    {
                        if (n_v < 3)
                        {
                            failFlag = YES;
                            failString = [NSString stringWithFormat:@"%@Face[%u] has fewer than three vertices.\n", failString, j];
                        }
                        else if (n_v > 3)
                        {
                            OOLogWARN(@"mesh.load.warning.nonTriangular", @"Face[%u] of %@ has %u vertices specified. Only the first three will be used.", j, baseFile, n_v);
                            n_v = 3;
                        }
                    }
                    else
                    {
                        failFlag = YES;
                        failString = [NSString stringWithFormat:@"%@Failed to read number of vertices for face[%d] in FACES\n", failString, j];
                    }
                    
                    if (!failFlag)
                    {
                        int vi;
                        for (i = 0; (int)i < n_v; i++)
                        {
                            if ([scanner scanInt:&vi])
                            {
                                _faces[j].vertex[i] = vi;
                                if (faceRefs != NULL)  VFRAddFace(&faceRefs[vi], j);
                            }
                            else
                            {
                                failFlag = YES;
                                failString = [NSString stringWithFormat:@"%@Failed to read vertex[%d] for face[%d] in FACES\n", failString, i, j];
                            }
                        }
                    }
                }
            }
        }
        else
        {
            failFlag = YES;
            failString = [NSString stringWithFormat:@"%@Failed to find FACES data\n",failString];
        }
 
        // Get textures data.
        if ([scanner scanString:@"TEXTURES" intoString:NULL])
        {
            for (j = 0; j < faceCount; j++)
            {
                NSString    *materialKey;
                float   max_x, max_y;
                float   s, t;
                if (!failFlag)
                {
                    // materialKey
                    //
                    [scanner scanCharactersFromSet:whitespaceAndNewlineCharSet intoString:NULL];
                    if (![scanner scanUpToCharactersFromSet:whitespaceCharSet intoString:&materialKey])
                    {
                        failFlag = YES;
                        failString = [NSString stringWithFormat:@"%@Failed to read texture filename for face[%d] in TEXTURES\n", failString, j];
                    }
                    else
                    {
                        NSNumber *index = [texFileName2Idx objectForKey:materialKey];
                        if (index != nil)
                        {
                            _faces[j].materialIndex = [index unsignedIntValue];
                        }
                        else
                        {
                            if (materialCount == kOOMeshMaxMaterials)
                            {
                                OOLog(kOOLogMeshTooManyMaterials, @"***** ERROR: model %@ has too many materials (maximum is %d)", filename, kOOMeshMaxMaterials);
                                return NO;
                            }
                            _faces[j].materialIndex = materialCount;
                            materialKeys[materialCount] = [materialKey retain];
                            index = [NSNumber numberWithUnsignedInt:materialCount];
                            [texFileName2Idx setObject:index forKey:materialKey];
                            ++materialCount;
                        }
                    }
 
                    // texture size
                    //
                   if (!failFlag)
                    {
                        if (![scanner scanFloat:&max_x])  failFlag = YES;
                        if (![scanner scanFloat:&max_y])  failFlag = YES;
                        if (failFlag)
                            failString = [NSString stringWithFormat:@"%@Failed to read texture size for max_x and max_y in face[%d] in TEXTURES\n", failString, j];
                    }
 
                    // vertices
                    //
                    if (!failFlag)
                    {
                        for (i = 0; i < 3; i++)
                        {
                            if (![scanner scanFloat:&s])  failFlag = YES;
                            if (![scanner scanFloat:&t])  failFlag = YES;
                            if (!failFlag)
                            {
                                _faces[j].s[i] = s / max_x;
                                _faces[j].t[i] = t / max_y;
                            }
                            else
                                failString = [NSString stringWithFormat:@"%@Failed to read s t coordinates for vertex[%d] in face[%d] in TEXTURES\n", failString, i, j];
                        }
                    }
                }
            }
        }
        else
        {
            failFlag = YES;
            failString = [failString stringByAppendingString:@"Failed to find TEXTURES data (will use placeholder material)\n"];
            materialKeys[0] = @"_oo_placeholder_material";
            materialCount = 1;
            
            for (j = 0; j < faceCount; j++)
            {
                _faces[j].materialIndex = 0;
            }
        }
        
        if ([scanner scanString:@"NAMES" intoString:NULL])
        {
            unsigned int count;
            if (![scanner scanInt:(int *)&count])
            {   
                failFlag = YES;
                failString = [failString stringByAppendingString:@"Expected count after NAMES\n"];
            }
            else
            {
                for (j = 0; j < count; j++)
                {
                    NSString *name = nil;
                    [scanner scanCharactersFromSet:whitespaceAndNewlineCharSet intoString:NULL];
                    if (![scanner scanUpToCharactersFromSet:newlineCharSet intoString:&name])
                    {
                        failFlag = YES;
                        failString = [failString stringByAppendingString:@"Expected file name\n"];
                    }
                    else
                    {
                        [self renameTexturesFrom:[NSString stringWithFormat:@"%u", j] to:name];
                    }
                }
            }
        }
        
        BOOL explicitTangents = NO;
        
        // Get explicit normals.
        if ([scanner scanString:@"NORMALS" intoString:NULL])
        {
            _normalMode = kNormalModeExplicit;
            if (![self allocateNormalBuffersWithCount:vertexCount])
            {
                OOLog(kOOLogAllocationFailure, @"***** ERROR: failed to allocate memory for model %@ (%u vertices).", filename, vertexCount);
                return NO;
            }
            
            for (j = 0; j < vertexCount; j++)
            {
                float x, y, z;
                if (!failFlag)
                {
                    if (![scanner scanFloat:&x])  failFlag = YES;
                    if (![scanner scanFloat:&y])  failFlag = YES;
                    if (![scanner scanFloat:&z])  failFlag = YES;
                    if (!failFlag)
                    {
                        _normals[j] = vector_normal(make_vector(x, y, z));
                    }
                    else
                    {
                        failString = [NSString stringWithFormat:@"%@Failed to read a value for vertex[%d] in %@\n", failString, j, @"NORMALS"];
                    }
                }
            }
            
            // Get explicit tangents (only together with vertices).
            if ([scanner scanString:@"TANGENTS" intoString:NULL])
            {
                for (j = 0; j < vertexCount; j++)
                {
                    float x, y, z;
                    if (!failFlag)
                    {
                        if (![scanner scanFloat:&x])  failFlag = YES;
                        if (![scanner scanFloat:&y])  failFlag = YES;
                        if (![scanner scanFloat:&z])  failFlag = YES;
                        if (!failFlag)
                        {
                            _tangents[j] = vector_normal(make_vector(x, y, z));
                        }
                        else
                        {
                            failString = [NSString stringWithFormat:@"%@Failed to read a value for vertex[%d] in %@\n", failString, j, @"TANGENTS"];
                        }
                    }
                }
            }
        }
        
        PROFILE(@"finished parsing");
        
        if (IsLegacyNormalMode(_normalMode))
        {
            [self checkNormalsAndAdjustWinding];
            PROFILE(@"finished checkNormalsAndAdjustWinding");
        }
        if (!explicitTangents)
        {
            [self generateFaceTangents];
            PROFILE(@"finished generateFaceTangents");
        }
        
        // check for smooth shading and recalculate normals
        if (_normalMode == kNormalModeSmooth)
        {
            if (![self allocateNormalBuffersWithCount:vertexCount])
            {
                OOLog(kOOLogAllocationFailure, @"***** ERROR: failed to allocate memory for model %@ (%u vertices).", filename, vertexCount);
                return NO;
            }
            [self calculateVertexNormalsAndTangentsWithFaceRefs:faceRefs];
            PROFILE(@"finished calculateVertexNormalsAndTangents");
            
        }
        else if (IsPerVertexNormalMode(_normalMode) && !explicitTangents)
        {
            [self calculateVertexTangentsWithFaceRefs:faceRefs];
            PROFILE(@"finished calculateVertexTangents");
        }
        
        // save the resulting data for possible reuse
        if (EXPECT(_cacheWriteable))
        {
            [OOCacheManager setMeshData:[self modelData] forName:cacheKey];
            PROFILE(@"saved to cache");
        }
        
        if (failFlag)
        {
            OOLog(@"mesh.error", @"%@ ..... from %@ %@", failString, filename, (using_preloaded)? @"(from preloaded data)" :@"(from file)");
        }
    }
    
    [self calculateBoundingVolumes];
    PROFILE(@"finished calculateBoundingVolumes");
    
    // set up vertex arrays for drawing
    if (![self setUpVertexArrays])  return NO;
    PROFILE(@"finished setUpVertexArrays");
    
    return YES;
    
    OOJS_PROFILE_EXIT
}

materials

- (NSDictionary *) materials

References shaders, and vertexCount.

Here is the call graph for this function:

meshRescaledBy:

- (OOMesh *) meshRescaledBy:

(GLfloat)

scaleFactor

Definition at line 791 of file OOMesh.m.

                          :(GLfloat)scaleFactor
{
    OOMesh *result = [self mutableCopy];
    [result rescaleByFactor:scaleFactor];
    return [result autorelease];
}

References rescaleByFactor:.

Referenced by OOVisualEffectEntity::rescaleBy:.

Here is the call graph for this function:

Here is the caller graph for this function:

meshWithName:cacheKey:materialDictionary:shadersDictionary:smooth:shaderMacros:shaderBindingTarget:

+ (instancetype) meshWithName:		(NSString *)	name
cacheKey:		(NSString *)	cacheKey
materialDictionary:		(NSDictionary *)	materialDict
shadersDictionary:		(NSDictionary *)	shadersDict
smooth:		(BOOL)	smooth
shaderMacros:		(NSDictionary *)	macros
shaderBindingTarget:		(id<OOWeakReferenceSupport>)	object

Definition at line 233 of file OOMesh.m.

                             :(NSString *)name
                     cacheKey:(NSString *)cacheKey
           materialDictionary:(NSDictionary *)materialDict
            shadersDictionary:(NSDictionary *)shadersDict
                       smooth:(BOOL)smooth
                 shaderMacros:(NSDictionary *)macros
          shaderBindingTarget:(id<OOWeakReferenceSupport>)object
{
    return [[[self alloc] initWithName:name
                              cacheKey:cacheKey
                    materialDictionary:materialDict
                     shadersDictionary:shadersDict
                                smooth:smooth
                          shaderMacros:macros
                   shaderBindingTarget:object
                           scaleFactor:1.0f
                        cacheWriteable:YES] autorelease];
}

Referenced by OOVisualEffectEntity::setUpVisualEffectFromDictionary:, ShipSetMaterialsInternal(), and VisualEffectSetMaterialsInternal().

Here is the caller graph for this function:

meshWithName:cacheKey:materialDictionary:shadersDictionary:smooth:shaderMacros:shaderBindingTarget:scaleFactor:cacheWriteable:

+ (instancetype) meshWithName:		(NSString *)	name
cacheKey:		(NSString *)	cacheKey
materialDictionary:		(NSDictionary *)	materialDict
shadersDictionary:		(NSDictionary *)	shadersDict
smooth:		(BOOL)	smooth
shaderMacros:		(NSDictionary *)	macros
shaderBindingTarget:		(id<OOWeakReferenceSupport>)	object
scaleFactor:		(float)	factor
cacheWriteable:		(BOOL)	cacheWriteable

Definition at line 252 of file OOMesh.m.

                             :(NSString *)name
                     cacheKey:(NSString *)cacheKey
           materialDictionary:(NSDictionary *)materialDict
            shadersDictionary:(NSDictionary *)shadersDict
                       smooth:(BOOL)smooth
                 shaderMacros:(NSDictionary *)macros
          shaderBindingTarget:(id<OOWeakReferenceSupport>)object
                  scaleFactor:(float)scale
               cacheWriteable:(BOOL)cacheWriteable
{
    return [[[self alloc] initWithName:name
                              cacheKey:cacheKey
                    materialDictionary:materialDict
                     shadersDictionary:shadersDict
                                smooth:smooth
                          shaderMacros:macros
                   shaderBindingTarget:object
                           scaleFactor:scale
                        cacheWriteable:cacheWriteable] autorelease];
}

Referenced by ShipEntity(Private)::rescaleBy:writeToCache:.

Here is the caller graph for this function:

modelData

- (NSDictionary *) modelData

implementation

Provided by category OOMesh(Private).

Definition at line 996 of file OOMesh.m.

{
    OOJS_PROFILE_ENTER
    
    NSNumber            *vertCnt = nil,
                        *faceCnt = nil;
    NSData              *vertData = nil,
                        *normData = nil,
                        *tanData = nil,
                        *faceData = nil;
    NSArray             *mtlKeys = nil;
    NSNumber            *normMode = nil;
    
    BOOL includeNormals = IsPerVertexNormalMode(_normalMode);
    
    // Prepare cache data elements.
    vertCnt = [NSNumber numberWithUnsignedInt:vertexCount];
    faceCnt = [NSNumber numberWithUnsignedInt:faceCount];
    
    vertData = [_retainedObjects objectForKey:@"vertices"];
    faceData = [_retainedObjects objectForKey:@"faces"];
    if (includeNormals)
    {
        normData = [_retainedObjects objectForKey:@"normals"];
        tanData = [_retainedObjects objectForKey:@"tangents"];
    }
    
    if (materialCount != 0)
    {
        mtlKeys = [NSArray arrayWithObjects:materialKeys count:materialCount];
    }
    else
    {
        mtlKeys = [NSArray array];
    }
    normMode = [NSNumber numberWithUnsignedChar:_normalMode];
    
    // Ensure we have all the required data elements.
    if (vertCnt == nil ||
        faceCnt == nil ||
        vertData == nil ||
        faceData == nil ||
        mtlKeys == nil ||
        normMode == nil)
    {
        return nil;
    }
    
    if (includeNormals)
    {
        if (normData == nil || tanData == nil)  return nil;
    }
    
    // All OK; stick 'em in a dictionary.
    return [NSDictionary dictionaryWithObjectsAndKeys:
                        vertCnt, @"vertex count",
                        vertData, @"vertex data",
                        faceCnt, @"face count",
                        faceData, @"face data",
                        mtlKeys, @"material keys",
                        normMode, @"normal mode",
                        /*  NOTE: order matters. Since normData and tanData
                            are last, if they're nil the dictionary will be
                            built without them, which is desired behaviour.
                        */
                        normData, @"normal data",
                        tanData, @"tangent data",
                        nil];
    
    OOJS_PROFILE_EXIT
}

Referenced by OOMesh(Private)::loadData:scaleFactor:.

Here is the caller graph for this function:

modelName

- (NSString *) modelName

Definition at line 367 of file OOMesh.m.

{
    return baseFile;
}

References baseFile, and modelName.

Referenced by descriptionComponents, modelName, and PlayerEntity::setUpTrumbles.

Here is the call graph for this function:

Here is the caller graph for this function:

mutableCopyWithZone:

- (id) mutableCopyWithZone: (NSZone *) zone

implementation

Provided by category OOMesh(Private).

Definition at line 941 of file OOMesh.m.

                         :(NSZone *)zone
{
    OOMesh              *result = nil;
    OOMeshMaterialCount  i;
    
    result = (OOMesh *)NSCopyObject(self, 0, zone);
    
    if (result != nil)
    {
        [result->baseFile retain];
        [result->baseFileOctreeCacheRef retain];
        [result->octree retain];
        [result->_retainedObjects retain];
        [result->_materialDict retain];
        [result->_shadersDict retain];
        [result->_cacheKey retain];
        [result->_shaderMacros retain];
        [result->_shaderBindingTarget retain];
        
        for (i = 0; i != kOOMeshMaxMaterials; ++i)
        {
            [result->materialKeys[i] retain];
            [result->materials[i] retain];
        }
        
        // Reset unsharable GL state
        result->listsReady = NO;
        
        [[OOGraphicsResetManager sharedManager] registerClient:result];
    }
    
    return result;
}

Referenced by copyWithZone:.

Here is the caller graph for this function:

NormalModeDescription

+ (static NSString *) NormalModeDescription (OOMeshNormalMode) mode

implementation

Definition at line 341 of file OOMesh.m.

{
    switch (mode)
    {
        case kNormalModePerFace:  return @"per-face";
        case kNormalModeSmooth:  return @"smooth";
        case kNormalModeExplicit:  return @"explicit";
    }
    
    return @"unknown";
}

References kNormalModeExplicit, kNormalModePerFace, and kNormalModeSmooth.

Referenced by dumpSelfState.

Here is the caller graph for this function:

octree

- (Octree *) octree

octreeDepth

- (unsigned) octreeDepth

implementation

Definition at line 641 of file OOMesh.m.

{
    float               threshold = kOctreeSizeThreshold;
    unsigned            result = kBaseOctreeDepth;
    GLfloat             xs, ys, zs, t, size;
    
    bounding_box_get_dimensions(boundingBox, &xs, &ys, &zs);
    // Shuffle dimensions around so zs is smallest
    if (xs < zs)  { t = zs; zs = xs; xs = t; }
    if (ys < zs)  { t = zs; zs = ys; ys = t; }
    size = (xs + ys) / 2.0f;    // Use average of two largest
    
    if (size < kOctreeSmallSizeThreshold)  result = kSmallOctreeDepth;
    else while (result < kMaxOctreeDepth)
    {
        if (size < threshold) break;
        threshold *= 2.0f;
        result++;
    }
    
    OOLog(@"mesh.load.octree.size", @"Selected octree depth %u for size %g for %@", result, size, baseFile);
    return result;
}

References baseFile, boundingBox, kBaseOctreeDepth, kMaxOctreeDepth, kOctreeSizeThreshold, kOctreeSmallSizeThreshold, kSmallOctreeDepth, octreeDepth, and OOLog.

Referenced by octreeDepth.

Here is the call graph for this function:

Here is the caller graph for this function:

placeholderMaterial

+ (OOMaterial *) placeholderMaterial

Definition at line 274 of file OOMesh.m.

{
    static OOBasicMaterial  *placeholderMaterial = nil;
    
    if (placeholderMaterial == nil)
    {
        placeholderMaterial = [[OOBasicMaterial alloc] initWithName:@"/placeholder/" configuration:[[ResourceManager materialDefaults] oo_dictionaryForKey:@"no-textures-material"]];
    }
    
    return placeholderMaterial;
}

References ResourceManager::materialDefaults, nil, and placeholderMaterial.

Referenced by placeholderMaterial, and rebindMaterials.

Here is the call graph for this function:

Here is the caller graph for this function:

rebindMaterials

- (void) rebindMaterials

Definition at line 567 of file OOMesh.m.

{
    OOMeshMaterialCount      i;
    OOMaterial              *material = nil;
    
    if (materialCount != 0)
    {
        for (i = 0; i != materialCount; ++i)
        {
            OOMaterial *oldMaterial = materials[i];
            
            if (![materialKeys[i] isEqualToString:@"_oo_placeholder_material"])
            {
                material = [OOMaterial materialWithName:materialKeys[i]
                                               cacheKey:_cacheKey
                                     materialDictionary:_materialDict
                                      shadersDictionary:_shadersDict
                                                 macros:_shaderMacros
                                          bindingTarget:[_shaderBindingTarget weakRefUnderlyingObject] // Windows DEP fix.
                                        forSmoothedMesh:IsPerVertexNormalMode(_normalMode)];
            }
            else
            {
                material = nil;
            }
            
            if (material != nil)
            {
                materials[i] = [material retain];
            }
            else
            {
                materials[i] = [[OOMesh placeholderMaterial] retain];
            }
            
            /*  Release is deferred to here to ensure we don't end up releasing
                a texture that's not in the recent-cache and then reloading it.
            */
            [oldMaterial release];
        }
    }
}

References materialCount, materialKeys, materials, OOMaterial::materialWithName:cacheKey:materialDictionary:shadersDictionary:macros:bindingTarget:forSmoothedMesh:, nil, placeholderMaterial, and rebindMaterials.

Referenced by OOMesh(Private)::initWithName:cacheKey:materialDictionary:shadersDictionary:smooth:shaderMacros:shaderBindingTarget:scaleFactor:cacheWriteable:, rebindMaterials, OOMesh(Private)::resetGraphicsState, and ShipEntity::setEntityPersonalityInt:.

Here is the call graph for this function:

Here is the caller graph for this function:

renameTexturesFrom:to:

- (void) renameTexturesFrom: (NSString *) from to: (NSString *) to

implementation

Provided by category OOMesh(Private).

Definition at line 2195 of file OOMesh.m.

                           :(NSString *)from to:(NSString *)to
{
    /*  IMPORTANT: this has to be called before setUpMaterials..., so it can
        only be used during loading.
    */
    OOMeshMaterialCount i;
    for (i = 0; i != materialCount; i++)
    {
        if ([materialKeys[i] isEqualToString:from])
        {
            [materialKeys[i] release];
            materialKeys[i] = [to copy];
        }
    }
}

Referenced by OOMesh(Private)::loadData:scaleFactor:.

Here is the caller graph for this function:

renderOpaqueParts

- (void) renderOpaqueParts

implementation

Reimplemented from OODrawable.

Definition at line 385 of file OOMesh.m.

{
    OO_ENTER_OPENGL();
    
    BOOL meshBelongsToVisualEffect = [_shaderBindingTarget isVisualEffect];
    
    OOSetOpenGLState(OPENGL_STATE_OPAQUE);
    
    OOGL(glVertexPointer(3, GL_FLOAT, 0, _displayLists.vertexArray));
    OOGL(glNormalPointer(GL_FLOAT, 0, _displayLists.normalArray));
    
    // for visual effects enable blending. This will allow use of alpha
    // channel in shaders - note, this is a bit of cheating the system,
    // which expects blending to be disabled at this point
    if (meshBelongsToVisualEffect)
    {
        OOGL(glEnable(GL_BLEND));
        OOGL(glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA));
    }
    
#if OO_SHADERS
    if ([[OOOpenGLExtensionManager sharedManager] shadersSupported])
    {
        OOGL(glEnableVertexAttribArrayARB(kTangentAttributeIndex));
        OOGL(glVertexAttribPointerARB(kTangentAttributeIndex, 3, GL_FLOAT, GL_FALSE, 0, _displayLists.tangentArray));
    }
#endif
    
    BOOL usingNormalsAsTexCoords = NO;
    OOMeshMaterialIndex ti;
    
    /*  FIXME: really, really horrible hack to set up texture coordinates for
        each texture unit. Very messy and still fails to handle some possibly-
        basic stuff, like switching usingNormalsAsTexCoords per texture unit.
        The right way to do this is probably to move attribute setup into the
        material model.
        -- Ahruman 2010-04-12
    */
#if OO_MULTITEXTURE
    if (_textureUnitCount == NSNotFound)
    {
        _textureUnitCount = 0;
        for (ti = 0; ti < materialCount; ti++)
        {
            NSUInteger count = [materials[ti] countOfTextureUnitsWithBaseCoordinates];
            if (_textureUnitCount < count)  _textureUnitCount = count;
        }
    }
    
    NSUInteger unit;
    if (_textureUnitCount <= 1)
    {
        OOGL(glEnableClientState(GL_TEXTURE_COORD_ARRAY));
    }
    else
    {
        /*  It should not be possible to have multiple texture units if
            texture combiners are not available.
        */
        NSAssert2([[OOOpenGLExtensionManager sharedManager] textureCombinersSupported], @"Mesh %@ uses %lu texture units, but multitexturing is not available.", [self shortDescription], _textureUnitCount);
        
        for (unit = 0; unit < _textureUnitCount; unit++)
        {
            OOGL(glClientActiveTextureARB(GL_TEXTURE0_ARB + unit));
            OOGL(glEnableClientState(GL_TEXTURE_COORD_ARRAY));
        }
    }
#else
    OOGL(glEnableClientState(GL_TEXTURE_COORD_ARRAY));
#endif
    
    @try
    {
        if (!listsReady)
        {
            OOGL(displayList0 = glGenLists(materialCount));
            
            // Ensure all textures are loaded
            for (ti = 0; ti < materialCount; ti++)
            {
                [materials[ti] ensureFinishedLoading];
            }
        }
        
        for (ti = 0; ti < materialCount; ti++)
        {
            BOOL wantsNormalsAsTextureCoordinates = [materials[ti] wantsNormalsAsTextureCoordinates];
            if (ti == 0 || wantsNormalsAsTextureCoordinates != usingNormalsAsTexCoords)
            {
                    // FIXME: enabling/disabling texturing should be handled by the material.
#if OO_MULTITEXTURE
                for (unit = 0; unit < _textureUnitCount; unit++)
                {
                    if (_textureUnitCount > 1)
                    {
                        OOGL(glClientActiveTextureARB(GL_TEXTURE0_ARB + unit));
                        OOGL(glActiveTextureARB(GL_TEXTURE0_ARB + unit));
                    }
#endif
                    if (!wantsNormalsAsTextureCoordinates)
                    {
                        OOGL(glDisable(GL_TEXTURE_CUBE_MAP));
                        OOGL(glTexCoordPointer(2, GL_FLOAT, 0, _displayLists.textureUVArray));
                        /*  FIXME: Not including the line below breaks multitexturing in no-shaders mode.
                            However, the OpenGL state manager should probably be handling this;
                            TEXTURE_2D is part of OPENGL_STATE_OPAQUE, which has already been set.
                            - Nikos 20130103
                        */
                        OOGL(glEnable(GL_TEXTURE_2D));
                    }
                    else
                    {
                        OOGL(glDisable(GL_TEXTURE_2D));
                        OOGL(glTexCoordPointer(3, GL_FLOAT, 0, _displayLists.vertexArray));
                        OOGL(glEnable(GL_TEXTURE_CUBE_MAP));
                    }
#if OO_MULTITEXTURE
                }
#endif
                usingNormalsAsTexCoords = wantsNormalsAsTextureCoordinates;
            }
            
            [materials[ti] apply];
            OOGL(glDrawArrays(GL_TRIANGLES, triangle_range[ti].location, triangle_range[ti].length));
        }
        
        listsReady = YES;
        brokenInRender = NO;
    }
    @catch (NSException *exception)
    {
        if (!brokenInRender)
        {
            OOLog(kOOLogException, @"***** %s for %@ encountered exception: %@ : %@ *****", __PRETTY_FUNCTION__, self, [exception name], [exception reason]);
            brokenInRender = YES;
        }
        if ([[exception name] hasPrefix:@"Oolite"])  [UNIVERSE handleOoliteException:exception];    // handle these ourself
        else  @throw exception; // pass these on
    }
    
#if OO_SHADERS
    if ([[OOOpenGLExtensionManager sharedManager] shadersSupported])
    {
        OOGL(glDisableVertexAttribArrayARB(kTangentAttributeIndex));
    }
#endif
    
    [OOMaterial applyNone];
    OOCheckOpenGLErrors(@"OOMesh after drawing %@", self);
    
#if OO_MULTITEXTURE
    if (_textureUnitCount <= 1)
    {
        OOGL(glDisableClientState(GL_TEXTURE_COORD_ARRAY));
    }
    else
    {
        for (unit = 0; unit < _textureUnitCount; unit++)
        {
            OOGL(glClientActiveTextureARB(GL_TEXTURE0_ARB + unit));
            OOGL(glDisableClientState(GL_TEXTURE_COORD_ARRAY));
        }
        
        OOGL(glClientActiveTextureARB(GL_TEXTURE0_ARB));
        OOGL(glActiveTextureARB(GL_TEXTURE0_ARB));
    }
#else
    OOGL(glDisableClientState(GL_TEXTURE_COORD_ARRAY));
#endif
    
#ifndef NDEBUG
    if (gDebugFlags & DEBUG_DRAW_NORMALS)  [self debugDrawNormals];
    if (gDebugFlags & DEBUG_OCTREE_DRAW)  [[self octree] drawOctree];
#endif
    
    // visual effect - disable previously enabled blending
    if (meshBelongsToVisualEffect)  OOGL(glDisable(GL_BLEND));
    
    OOVerifyOpenGLState();
}

References _displayLists, OOMaterial::apply, OOMaterial::applyNone, brokenInRender, count, DEBUG_DRAW_NORMALS, DEBUG_OCTREE_DRAW, debugDrawNormals, displayList0, Octree::drawOctree, OOMaterial::ensureFinishedLoading, gDebugFlags, kOOLogException, listsReady, materialCount, octree, OO_ENTER_OPENGL, OOCheckOpenGLErrors(), OOGL, OOLog, OOSetOpenGLState, OOVerifyOpenGLState, OPENGL_STATE_OPAQUE, renderOpaqueParts, triangle_range, and OOMaterial::wantsNormalsAsTextureCoordinates.

Referenced by renderOpaqueParts.

Here is the call graph for this function:

Here is the caller graph for this function:

rescaleByFactor:

- (void) rescaleByFactor: (GLfloat) factor

implementation

Provided by category OOMesh(Private).

Definition at line 2022 of file OOMesh.m.

                        :(GLfloat)factor
{
    // Rescale base vertices used for geometry calculations.
    OOMeshVertexCount  i;
    Vector              *vertex = NULL;
    
    for (i = 0; i < vertexCount; i++)
    {
        vertex = &_vertices[i];
        *vertex = vector_multiply_scalar(*vertex, factor);
    }
    
    // Rescale actual display vertices.
    for (i = 0; i < _displayLists.count; i++)
    {
        vertex = &_displayLists.vertexArray[i];
        *vertex = vector_multiply_scalar(*vertex, factor);
    }
    
    [self calculateBoundingVolumes];
    DESTROY(octree);
    DESTROY(baseFile);   // Avoid octree cache.
    DESTROY(baseFileOctreeCacheRef);
}

Referenced by meshRescaledBy:.

Here is the caller graph for this function:

resetGraphicsState

- (void) resetGraphicsState

implementation

Provided by category OOMesh(Private).

Definition at line 988 of file OOMesh.m.

{
    [self deleteDisplayLists];
    [self rebindMaterials];
    _textureUnitCount = NSNotFound;
}

setBindingTarget:

- (void) setBindingTarget: (id<OOWeakReferenceSupport>) target

implementation

Reimplemented from OODrawable.

Definition at line 799 of file OOMesh.m.

                        :(id<OOWeakReferenceSupport>)target
{
    unsigned                i;
    
    for (i = 0; i != kOOMeshMaxMaterials; ++i)
    {
        [materials[i] setBindingTarget:target];
    }
}

References kOOMeshMaxMaterials, and OOMaterial::setBindingTarget:.

Here is the call graph for this function:

setModelFromModelData:name:

- (BOOL) setModelFromModelData: (NSDictionary*) dict name: (NSString *) fileName

implementation

Provided by category OOMesh(Private).

Definition at line 1069 of file OOMesh.m.

                             :(NSDictionary *)dict name:(NSString *)fileName
{
    OOJS_PROFILE_ENTER
    
    NSData              *vertData = nil,
                        *normData = nil,
                        *tanData = nil,
                        *faceData = nil;
    NSArray             *mtlKeys = nil;
    NSString            *key = nil;
    unsigned            i;
    
    if (dict == nil || ![dict isKindOfClass:[NSDictionary class]])  return NO;
    
    vertexCount = [dict oo_unsignedIntForKey:@"vertex count"];
    faceCount = [dict oo_unsignedIntForKey:@"face count"];
    
    if (vertexCount == 0 || faceCount == 0)  return NO;
    
    // Read data elements from dictionary.
    vertData = [dict oo_dataForKey:@"vertex data"];
    faceData = [dict oo_dataForKey:@"face data"];
    
    mtlKeys = [dict oo_arrayForKey:@"material keys"];
    _normalMode = [dict oo_unsignedCharForKey:@"normal mode"];
    BOOL includeNormals = IsPerVertexNormalMode(_normalMode);
    
    // Ensure we have all the required data elements.
    if (vertData == nil ||
        faceData == nil ||
        mtlKeys == nil)
    {
        OOLog(@"mesh.load.error.badCacheData", @"Ignoring bad cache data for mesh \"%@\".", fileName);
        return NO;
    }
    
    if (includeNormals)
    {
        normData = [dict oo_dataForKey:@"normal data"];
        tanData = [dict oo_dataForKey:@"tangent data"];
        if (normData == nil || tanData == nil)
        {
            OOLog(@"mesh.load.error.badCacheData", @"Ignoring bad normal/tangent cache data for mesh \"%@\".", fileName);
            return NO;
        }
    }
    
    // Ensure data objects are of correct size.
    if ([vertData length] != sizeof *_vertices * vertexCount)  return NO;
    if ([faceData length] != sizeof *_faces * faceCount)  return NO;
    if (includeNormals)
    {
        if ([normData length] != sizeof *_normals * vertexCount)  return NO;
        if ([tanData length] != sizeof *_tangents * vertexCount)  return NO;
    }
    
    // Retain data.
    _vertices = (Vector *)[vertData bytes];
    [self setRetainedObject:vertData forKey:@"vertices"];
    _faces = (OOMeshFace *)[faceData bytes];
    [self setRetainedObject:faceData forKey:@"faces"];
    if (includeNormals)
    {
        _normals = (Vector *)[normData bytes];
        [self setRetainedObject:normData forKey:@"normals"];
        _tangents = (Vector *)[tanData bytes];
        [self setRetainedObject:tanData forKey:@"tangents"];
    }
    else
    {
        _normals = NULL;
        _tangents = NULL;
    }
    
    // Copy material keys.
    materialCount = [mtlKeys count];
    for (i = 0; i != materialCount; ++i)
    {
        key = [mtlKeys oo_stringAtIndex:i];
        if (key != nil)  materialKeys[i] = [key copy];
        else
        {
            OOLog(@"mesh.load.error.badCacheData", @"Ignoring bad cache data for mesh \"%@\".", fileName);
            return NO;
        }
    }
    
    return YES;
    
    OOJS_PROFILE_EXIT
}

setRetainedObject:forKey:

- (void) setRetainedObject: (id) object forKey: (NSString *) key

implementation

Provided by category OOMesh(Private).

Definition at line 2108 of file OOMesh.m.

                          :(id)object forKey:(NSString *)key
{
    assert(key != nil);
    
    if (object != nil)
    {
        if (_retainedObjects == nil)  _retainedObjects = [[NSMutableDictionary alloc] init];
        [_retainedObjects setObject:object forKey:key];
    }
}

Referenced by OOMesh(Private)::allocateBytesWithSize:count:key:, and OOMesh(Private)::setModelFromModelData:name:.

Here is the caller graph for this function:

setUpVertexArrays

- (BOOL) setUpVertexArrays

implementation

Provided by category OOMesh(Private).

Definition at line 1887 of file OOMesh.m.

{
    OOJS_PROFILE_ENTER
    
    NSUInteger  fi, vi, mi;
    
    if (![self allocateVertexArrayBuffersWithCount:faceCount])  return NO;
    
    // if smoothed, find any vertices that are between faces of different
    // smoothing groups and mark them as being on an edge and therefore NOT
    // smooth shaded
    BOOL is_edge_vertex[vertexCount];
    GLfloat smoothGroup[vertexCount];
    for (vi = 0; vi < vertexCount; vi++)
    {
        is_edge_vertex[vi] = NO;
        smoothGroup[vi] = -1;
    }
    if (_normalMode == kNormalModeSmooth)
    {
        for (fi = 0; fi < faceCount; fi++)
        {
            GLfloat rv = _faces[fi].smoothGroup;
            int i;
            for (i = 0; i < 3; i++)
            {
                vi = _faces[fi].vertex[i];
                if (smoothGroup[vi] < 0.0)  // unassigned
                    smoothGroup[vi] = rv;
                else if (smoothGroup[vi] != rv) // a different colour
                    is_edge_vertex[vi] = YES;
            }
        }
    }
 
 
    // base model, flat or smooth shaded, all triangles
    int tri_index = 0;
    int uv_index = 0;
    int vertex_index = 0;
    
    // Iterate over material names
    for (mi = 0; mi != materialCount; ++mi)
    {
        triangle_range[mi].location = tri_index;
        
        for (fi = 0; fi < faceCount; fi++)
        {
            Vector normal, tangent;
            
            if (_faces[fi].materialIndex == mi)
            {
                for (vi = 0; vi < 3; vi++)
                {
                    int v = _faces[fi].vertex[vi];
                    if (IsPerVertexNormalMode(_normalMode))
                    {
                        if (is_edge_vertex[v])
                        {
                            [self getNormal:&normal andTangent:&tangent forVertex:v inSmoothGroup:_faces[fi].smoothGroup];
                        }
                        else
                        {
                            NSAssert1(_normals != NULL && _tangents != NULL, @"Normal/tangent buffers not allocated in %s", __PRETTY_FUNCTION__);
                            
                            normal = _normals[v];
                            tangent = _tangents[v];
                        }
                    }
                    else
                    {
                        normal = _faces[fi].normal;
                        tangent = _faces[fi].tangent;
                    }
                    
                    // FIXME: avoid redundant vertices so index array is actually useful.
                    _displayLists.indexArray[tri_index++] = vertex_index;
                    _displayLists.normalArray[vertex_index] = normal;
                    _displayLists.tangentArray[vertex_index] = tangent;
                    _displayLists.vertexArray[vertex_index++] = _vertices[v];
                    _displayLists.textureUVArray[uv_index++] = _faces[fi].s[vi];
                    _displayLists.textureUVArray[uv_index++] = _faces[fi].t[vi];
                }
            }
        }
        triangle_range[mi].length = tri_index - triangle_range[mi].location;
    }
    
    _displayLists.count = tri_index;   // total number of triangle vertices
    return YES;
    
    OOJS_PROFILE_EXIT
}

shaders

- (NSDictionary *) shaders

Definition at line 617 of file OOMesh.m.

{
    return _shadersDict;
}

References _shadersDict, and shaders.

Referenced by materials, shaders, ShipSetMaterialsInternal(), VisualEffectGetShaders(), and VisualEffectSetMaterialsInternal().

Here is the call graph for this function:

Here is the caller graph for this function:

suppressClangStuff

- (BOOL) suppressClangStuff

implementation

Definition at line 863 of file OOMesh.m.

{
    return _normals && _tangents && _faces && boundingBox.min.x;
}

References _faces, _normals, _tangents, boundingBox, and suppressClangStuff.

Referenced by suppressClangStuff.

Here is the call graph for this function:

Here is the caller graph for this function:

totalSize

- (size_t) totalSize

implementation

Reimplemented from OODrawable.

Definition at line 836 of file OOMesh.m.

{
    size_t result = [super totalSize];
    if (_vertices != NULL)  result += sizeof *_vertices * vertexCount;
    if (_normals != NULL)  result += sizeof *_normals * vertexCount;
    if (_tangents != NULL)  result += sizeof *_tangents * vertexCount;
    if (_faces != NULL)  result += sizeof *_faces * faceCount;
    
    result += _displayLists.count * (sizeof (GLint) + sizeof (GLfloat) + sizeof (Vector) * 3);
    
    OOMeshMaterialCount i;
    for (i = 0; i != materialCount; i++)
    {
        result += [materials[i] oo_objectSize];
    }
    
    result += [octree totalSize];
    return result;
}

References _displayLists, _faces, _normals, _tangents, _vertices, faceCount, materialCount, Octree::totalSize, OODrawable::totalSize, totalSize, and vertexCount.

Referenced by totalSize.

Here is the call graph for this function:

Here is the caller graph for this function:

vertexCount

- (size_t) vertexCount

References faceCount.

Member Data Documentation

_cacheKey

- (NSString*) _cacheKey

private

Definition at line 128 of file OOMesh.h.

Referenced by dealloc.

_cacheWriteable

- (BOOL) _cacheWriteable

private

Definition at line 103 of file OOMesh.h.

Referenced by init.

_displayLists

- (OOMeshDisplayLists) _displayLists

private

Definition at line 111 of file OOMesh.h.

Referenced by renderOpaqueParts, and totalSize.

_faces

- (OOMeshFace*) _faces

private

Definition at line 108 of file OOMesh.h.

Referenced by suppressClangStuff, and totalSize.

_lastBoundingBox

- (BoundingBox) _lastBoundingBox

private

Definition at line 134 of file OOMesh.h.

Referenced by findSubentityBoundingBoxWithPosition:rotMatrix:, and init.

_lastPosition

- (Vector) _lastPosition

private

Definition at line 132 of file OOMesh.h.

Referenced by findSubentityBoundingBoxWithPosition:rotMatrix:, and init.

_lastRotMatrix

- (OOMatrix) _lastRotMatrix

private

Definition at line 133 of file OOMesh.h.

Referenced by findSubentityBoundingBoxWithPosition:rotMatrix:, and init.

_materialDict

- (NSDictionary*) _materialDict

private

Definition at line 126 of file OOMesh.h.

Referenced by dealloc.

_normalMode

- (uint8_t) _normalMode

private

Definition at line 93 of file OOMesh.h.

Referenced by dumpSelfState.

_normals

- (Vector*) _normals

private

Definition at line 106 of file OOMesh.h.

Referenced by suppressClangStuff, and totalSize.

_retainedObjects

- (NSMutableDictionary*) _retainedObjects

private

Definition at line 124 of file OOMesh.h.

Referenced by dealloc.

_shaderBindingTarget

- (id) _shaderBindingTarget

private

Definition at line 130 of file OOMesh.h.

Referenced by dealloc.

_shaderMacros

- (NSDictionary*) _shaderMacros

private

Definition at line 129 of file OOMesh.h.

Referenced by dealloc.

_shadersDict

- (NSDictionary*) _shadersDict

private

Definition at line 127 of file OOMesh.h.

Referenced by dealloc, and shaders.

_tangents

- (Vector*) _tangents

private

Definition at line 107 of file OOMesh.h.

Referenced by suppressClangStuff, and totalSize.

_vertices

- (Vector*) _vertices

private

Definition at line 105 of file OOMesh.h.

Referenced by findBoundingBoxRelativeToPosition:basis:ri:rj:selfPosition:selfBasis:si:sj:, findSubentityBoundingBoxWithPosition:rotMatrix:, and totalSize.

baseFile

- (NSString*) baseFile

private

Definition at line 101 of file OOMesh.h.

Referenced by dealloc, dumpSelfState, init, modelName, and octreeDepth.

baseFileOctreeCacheRef

- (NSString*) baseFileOctreeCacheRef

private

Definition at line 102 of file OOMesh.h.

Referenced by dealloc, and init.

boundingBox

- (BoundingBox) boundingBox

private

Provided by category OOMesh(Private).

Definition at line 120 of file OOMesh.h.

References OOMesh(Private)::boundingBox.

Referenced by OOMesh(Private)::boundingBox, OOMesh(Private)::calculateBoundingVolumes, octreeDepth, and suppressClangStuff.

brokenInRender

- (uint8_t) brokenInRender

private

Definition at line 94 of file OOMesh.h.

Referenced by renderOpaqueParts.

collisionRadius

- (GLfloat) collisionRadius

private

Definition at line 628 of file OOMesh.m.

{
    return collisionRadius;
}

Referenced by descriptionComponents.

displayList0

- (GLuint) displayList0

private

Definition at line 116 of file OOMesh.h.

Referenced by renderOpaqueParts.

faceCount

- (size_t) faceCount

private

Definition at line 379 of file OOMesh.m.

{
    return faceCount;
}

Referenced by descriptionComponents, dumpSelfState, totalSize, and vertexCount.

listsReady

- (uint8_t) listsReady

private

Definition at line 95 of file OOMesh.h.

Referenced by OOMesh(Private)::mutableCopyWithZone:, and renderOpaqueParts.

materialCount

- (OOMeshMaterialCount) materialCount

private

Definition at line 97 of file OOMesh.h.

Referenced by allTextures, rebindMaterials, renderOpaqueParts, and totalSize.

materialKeys

- (NSString* materialKeys[kOOMeshMaxMaterials])

private

Definition at line 114 of file OOMesh.h.

Referenced by dealloc, and rebindMaterials.

materials

- (NSDictionary *) materials

private

Definition at line 611 of file OOMesh.m.

{
    return _materialDict;
}

Referenced by dealloc, rebindMaterials, ShipSetMaterialsInternal(), VisualEffectGetMaterials(), and VisualEffectSetMaterialsInternal().

maxDrawDistance

- (GLfloat) maxDrawDistance

private

Definition at line 634 of file OOMesh.m.

{
    return maxDrawDistance;
}

octree

- (Octree *) octree

private

Definition at line 672 of file OOMesh.m.

{
    if (octree == nil)
    {
        octree = [[OOCacheManager octreeForModel:baseFileOctreeCacheRef] retain];
        if (octree == nil)
        {
            NSAutoreleasePool *pool = [[NSAutoreleasePool alloc] init];
            
            OOMeshToOctreeConverter *converter = [OOMeshToOctreeConverter converterWithCapacity:faceCount];
            OOMeshFaceCount i;
            for (i = 0; i < faceCount; i++)
            {
                // Somewhat surprisingly, this method doesn't even show up in profiles. -- Ahruman 2012-09-22
                Triangle tri;
                tri.v[0] = _vertices[_faces[i].vertex[0]];
                tri.v[1] = _vertices[_faces[i].vertex[1]];
                tri.v[2] = _vertices[_faces[i].vertex[2]];
                [converter addTriangle:tri];
            }
            
            octree = [converter findOctreeToDepth:[self octreeDepth]];
            [octree retain];
            if (EXPECT(_cacheWriteable))
            {
                [OOCacheManager setOctree:octree forModel:baseFileOctreeCacheRef];
            }
            
            [pool release];
        }
        else
        {
            OOLog(@"mesh.load.octreeCached", @"Retrieved octree \"%@\" from cache.", baseFileOctreeCacheRef);
        }
    }
    
    return octree;
}

Referenced by dealloc, faceCount, renderOpaqueParts, and ShipEntity::setMesh:.

triangle_range

- (NSRange triangle_range[kOOMeshMaxMaterials])

private

Definition at line 113 of file OOMesh.h.

Referenced by renderOpaqueParts.

vertexCount

- (size_t) vertexCount

private

Definition at line 373 of file OOMesh.m.

{
    return vertexCount;
}

Referenced by descriptionComponents, dumpSelfState, findBoundingBoxRelativeToPosition:basis:ri:rj:selfPosition:selfBasis:si:sj:, findSubentityBoundingBoxWithPosition:rotMatrix:, materials, and totalSize.

---

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

• src/Core/OOMesh.h
• src/Core/OOMesh.m