OOParticleSystem.m

Go to the documentation of this file.

/*
 
OOParticleSystem.m
 
Oolite
Copyright (C) 2004-2013 Giles C Williams and contributors
 
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
 
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
 
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
MA 02110-1301, USA.
 
*/
 
#import "OOParticleSystem.h"
 
#import "Universe.h"
#import "OOTexture.h"
#import "PlayerEntity.h"
#import "OOLightParticleEntity.h"
#import "OOMacroOpenGL.h"
#import "MyOpenGLView.h"
 
 
//  Testing toy: cause particle systems to stop after half a second.
#define FREEZE_PARTICLES    0
 
 
@implementation OOParticleSystem
 
- (id) init
{
    [self release];
    return nil;
}
- (id) init {…}
 
 
/*  Initialize shared aspects of the fragburst entities.
    Also stashes generated particle speeds in _particleSize[] array.
*/
- (id) initWithPosition:(HPVector)pos
               velocity:(Vector)vel
                  count:(unsigned)count
               minSpeed:(float)minSpeed
               maxSpeed:(float)maxSpeed
               duration:(OOTimeDelta)duration
              baseColor:(GLfloat[4])baseColor
{
    NSParameterAssert(count <= kFragmentBurstMaxParticles);
    
    if ((self = [super init]))
    {
        _count = count;
        [self setPosition:pos];
        
        velocity = vel;
        _duration = duration;
        _maxSpeed = maxSpeed;
        
        for (unsigned i = 0; i < count; i++)
        {
            GLfloat speed = minSpeed + 0.5f * (randf()+randf()) * (maxSpeed - minSpeed); // speed tends toward middle of range
            _particleVelocity[i] = vector_multiply_scalar(OORandomUnitVector(), speed);
            
            Vector color = make_vector(baseColor[0] * 0.1f * (9.5f + randf()), baseColor[1] * 0.1f * (9.5f + randf()), baseColor[2] * 0.1f * (9.5f + randf()));
            color = vector_normal(color);
            _particleColor[i][0] = color.x;
            _particleColor[i][1] = color.y;
            _particleColor[i][2] = color.z;
            _particleColor[i][3] = baseColor[3];
            
            _particleSize[i] = speed;
        }
        
        [self setStatus:STATUS_EFFECT];
        scanClass = CLASS_NO_DRAW;
    }
    
    return self;
}
- (id) initWithPosition:(HPVector)pos {…}
 
 
- (NSString *) descriptionComponents
{
    return [NSString stringWithFormat:@"ttl: %.3fs", _duration - _timePassed];
}
- (NSString *) descriptionComponents {…}
 
 
- (BOOL) canCollide
{
    return NO;
}
- (BOOL) canCollide {…}
 
 
- (BOOL) checkCloseCollisionWith:(Entity *)other
{
    if (other == [self owner])  return NO;
    return ![other isEffect];
}
- (BOOL) checkCloseCollisionWith:(Entity *)other {…}
 
 
- (void) update:(OOTimeDelta) delta_t
{
    [super update:delta_t];
    
    _timePassed += delta_t;
    collision_radius += delta_t * _maxSpeed;
    
    unsigned    i, count = _count;
    Vector      *particlePosition = _particlePosition;
    Vector      *particleVelocity = _particleVelocity;
    
    for (i = 0; i < count; i++)
    {
        particlePosition[i] = vector_add(particlePosition[i], vector_multiply_scalar(particleVelocity[i], delta_t));
    }
    
    // disappear eventually.
    if (_timePassed > _duration)  [UNIVERSE removeEntity:self];
}
- (void) update:(OOTimeDelta) delta_t {…}
 
 
#define DrawQuadForView(x, y, z, sz) \
do { \
    glTexCoord2f(0.0, 1.0); glVertex3f(x-sz, y-sz, z); \
    glTexCoord2f(1.0, 1.0); glVertex3f(x+sz, y-sz, z); \
    glTexCoord2f(1.0, 0.0); glVertex3f(x+sz, y+sz, z); \
    glTexCoord2f(0.0, 0.0); glVertex3f(x-sz, y+sz, z); \
} while (0)
#define DrawQuadForView(x, y, z, sz) \ …
 
 
- (void) drawImmediate:(bool)immediate translucent:(bool)translucent
{
    if (!translucent || [UNIVERSE breakPatternHide])  return;
 
    OO_ENTER_OPENGL();
    OOSetOpenGLState(OPENGL_STATE_ADDITIVE_BLENDING);
    
    OOGL(glPushAttrib(GL_ENABLE_BIT | GL_COLOR_BUFFER_BIT));
    
    OOGL(glEnable(GL_TEXTURE_2D));
    OOGL(glEnable(GL_BLEND));
    OOGL(glBlendFunc(GL_SRC_ALPHA, GL_ONE));
    [[self texture] apply];
    
    HPVector        viewPosition = [PLAYER viewpointPosition];
    HPVector        selfPosition = [self position];
    
    unsigned    i, count = _count;
    Vector      *particlePosition = _particlePosition;
    GLfloat     (*particleColor)[4] = _particleColor;
    GLfloat     *particleSize = _particleSize;
    
    if ([UNIVERSE reducedDetail])
    {
        // Quick rendering - particle cloud is effectively a 2D billboard.
        OOGLPushModelView();
        OOGLMultModelView(OOMatrixForBillboard(selfPosition, viewPosition));
        
        OOGLBEGIN(GL_QUADS);
        for (i = 0; i < count; i++)
        {
            glColor4fv(particleColor[i]);
            DrawQuadForView(particlePosition[i].x, particlePosition[i].y, particlePosition[i].z, particleSize[i]);
        }
        OOGLEND();
        
        OOGLPopModelView();
    }
    else
    {
        float distanceThreshold = collision_radius * 2.0f;  // Distance between player and middle of effect where we start to transition to "non-fast rendering."
        float thresholdSq = distanceThreshold * distanceThreshold;
        float distanceSq = cam_zero_distance;
        
        if (distanceSq > thresholdSq)
        {
            /*  Semi-quick rendering - particle positions are volumetric, but
                orientation is shared. This can cause noticeable distortion
                if the player is close to the centre of the cloud.
            */
            OOMatrix bbMatrix = OOMatrixForBillboard(selfPosition, viewPosition);
            
            for (i = 0; i < count; i++)
            {
                OOGLPushModelView();
                OOGLTranslateModelView(particlePosition[i]);
                OOGLMultModelView(bbMatrix);
                
                glColor4fv(particleColor[i]);
                OOGLBEGIN(GL_QUADS);
                    DrawQuadForView(0, 0, 0, particleSize[i]);
                OOGLEND();
                
                OOGLPopModelView();
            }
        }
        else
        {
            /*  Non-fast rendering - each particle is billboarded individually.
                The "individuality" factor interpolates between this behavior
                and "semi-quick" to avoid jumping at the boundary.
            */
            float individuality = 3.0f * (1.0f - distanceSq / thresholdSq);
            individuality = OOClamp_0_1_f(individuality);
            
            for (i = 0; i < count; i++)
            {
                OOGLPushModelView();
                OOGLTranslateModelView(particlePosition[i]);
                OOGLMultModelView(OOMatrixForBillboard(HPvector_add(selfPosition, vectorToHPVector(vector_multiply_scalar(particlePosition[i], individuality))), viewPosition));
                
                glColor4fv(particleColor[i]);
                OOGLBEGIN(GL_QUADS);
                DrawQuadForView(0, 0, 0, particleSize[i]);
                OOGLEND();
                
                OOGLPopModelView();
            }
        }
 
    }
    
    OOGL(glPopAttrib());
    
    OOVerifyOpenGLState();
    OOCheckOpenGLErrors(@"OOParticleSystem after drawing %@", self);
}
- (void) drawImmediate:(bool)immediate translucent:(bool)translucent {…}
 
 
- (BOOL) isEffect
{
    return YES;
}
- (BOOL) isEffect {…}
 
- (OOTexture *) texture
{
    return [OOLightParticleEntity defaultParticleTexture];
}
- (OOTexture *) texture {…}
 
#ifndef NDEBUG
- (NSSet *) allTextures
{
    return [NSSet setWithObject:[OOLightParticleEntity defaultParticleTexture]];
}
- (NSSet *) allTextures {…}
#endif
 
@end
 
 
@implementation OOSmallFragmentBurstEntity: OOParticleSystem
 
- (id) initFragmentBurstFrom:(HPVector)fragPosition velocity:(Vector)fragVelocity size:(GLfloat)size
{
    enum
    {
        kMinSpeed = 100, kMaxSpeed = 400
    };
        kMinSpeed = 100, kMaxSpeed = 400 {…};
    
    unsigned count = 0.4f * size;
    count = MIN(count | 12, (unsigned)kFragmentBurstMaxParticles);
    
    // Select base colour
    // yellow/orange (0.12) through yellow (0.1667) to yellow/slightly green (0.20)
    OOColor *hsvColor = [OOColor colorWithHue:0.12f + 0.08f * randf() saturation:1.0f brightness:1.0f alpha:1.0f];
    GLfloat baseColor[4];
    [hsvColor getRed:&baseColor[0] green:&baseColor[1] blue:&baseColor[2] alpha:&baseColor[3]];
    
    if ((self = [super initWithPosition:fragPosition velocity:fragVelocity count:count minSpeed:kMinSpeed maxSpeed:kMaxSpeed duration:1.5 baseColor:baseColor]))
    {
        for (unsigned i = 0; i < count; i++)
        {
            // Note: initWithPosition:... stashes speeds in _particleSize[].
            _particleSize[i] = 32.0f * kMinSpeed / _particleSize[i];
        }
    }
    if ((self = [super initWithPosition:fragPosition velocity:fragVelocity count:count minSpeed:kMinSpeed maxSpeed:kMaxSpeed duration:1.5 baseColor:baseColor])) {…}
    
    return self;
}
 
 
+ (id) fragmentBurstFromEntity:(Entity *)entity
{
    return [[[self alloc] initFragmentBurstFrom:[entity position] velocity:[entity velocity] size:[entity collisionRadius]] autorelease];
}
+ (id) fragmentBurstFromEntity:(Entity *)entity {…}
 
 
- (void) update:(OOTimeDelta) delta_t
{
#if FREEZE_PARTICLES
    if (_timePassed + delta_t > 0.5) delta_t = 0.5 - _timePassed;
#endif
    
    [super update:delta_t];
    
    unsigned    i, count = _count;
    GLfloat     (*particleColor)[4] = _particleColor;
    GLfloat     timePassed = _timePassed;
    
    for (i = 0; i < count; i++)
    {
        GLfloat du = 0.5f + (1.0f/32.0f) * (32 - i);
        particleColor[i][3] = OOClamp_0_1_f(1.0f - timePassed / du);
    }
}
- (void) update:(OOTimeDelta) delta_t {…}
 
@end
 
 
@implementation OOBigFragmentBurstEntity: OOParticleSystem
 
- (id) initFragmentBurstFrom:(HPVector)fragPosition velocity:(Vector)fragVelocity size:(GLfloat)size
{
    float minSpeed = 1.0f + size * 0.5f;
    float maxSpeed = minSpeed * 4.0f;
    
    unsigned count = 0.2f * size;
    count = MIN(count | 3, (unsigned)kBigFragmentBurstMaxParticles);
    
    GLfloat baseColor[4] = { 1.0f, 1.0f, 0.5f, 1.0f }; 
    
    size *= 2.0f;    // Account for margins in particle texture.
    if ((self = [super initWithPosition:fragPosition velocity:fragVelocity count:count minSpeed:minSpeed maxSpeed:maxSpeed duration:1.0 baseColor:baseColor]))
    {
        _baseSize = size;
        
        for (unsigned i = 0; i < count; i++)
        {
            _particleSize[i] = size;
        }
    }
    if ((self = [super initWithPosition:fragPosition velocity:fragVelocity count:count minSpeed:minSpeed maxSpeed:maxSpeed duration:1.0 baseColor:baseColor])) {…}
    
    return self;
}
 
 
+ (id) fragmentBurstFromEntity:(Entity *)entity
{
    return [[[self alloc] initFragmentBurstFrom:[entity position] velocity:vector_multiply_scalar([entity velocity], 0.85) size:[entity collisionRadius]] autorelease];
}
+ (id) fragmentBurstFromEntity:(Entity *)entity {…}
 
 
- (void) update:(double)delta_t
{
#if FREEZE_PARTICLES
    if (_timePassed + delta_t > 0.5) delta_t = 0.5 - _timePassed;
#endif
    
    [super update:delta_t];
    
    unsigned    i, count = _count;
    GLfloat     (*particleColor)[4] = _particleColor;
    GLfloat     *particleSize = _particleSize;
    GLfloat     timePassed = _timePassed;
    GLfloat     duration = _duration;
    
    GLfloat size = (1.0f + timePassed) * _baseSize;
    GLfloat di = 1.0f / (count - 1);
    
    for (i = 0; i < count; i++)
    {
        GLfloat du = duration * (0.5f + di * i);
        particleColor[i][3] = OOClamp_0_1_f(1.0f - timePassed / du);
        
        particleSize[i] = size;
    }
}
- (void) update:(double)delta_t {…}
 
@end