lescegra api documentation - particlesource.h Source File

00001 /*********************************************************************
00002 * lescegra                                                           *
00003 *                                                                    *
00004 * http://geeky.kicks-ass.org/projects/lescegra.html                  *
00005 *                                                                    *
00006 * Copyright 2003 by Enno Cramer <uebergeek@web.de>                   *
00007 *                                                                    *
00008 * This library is free software; you can redistribute it and/or      *
00009 * modify it under the terms of the GNU Library General Public        *
00010 * License as published by the Free Software Foundation; either       *
00011 * version 2 of the License, or (at your option) any later version.   *
00012 *                                                                    *
00013 * This library is distributed in the hope that it will be useful,    *
00014 * but WITHOUT ANY WARRANTY; without even the implied warranty of     *
00015 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU  *
00016 * Library General Public License for more details.                   *
00017 *                                                                    *
00018 * You should have received a copy of the GNU Library General Public  *
00019 * License along with this library; if not, write to the Free         *
00020 * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. *
00021 *********************************************************************/
00022 
00023 #ifndef LSG_PARTICLESOURCE_H
00024 #define LSG_PARTICLESOURCE_H 1
00025 
00026 /**
00027  * \file  particlesource.h
00028  * \brief Constant source of new particles
00029  */
00030 
00031 #include <lescegra/particle/particlemodifier.h>
00032 
00033 #include <lescegra/particle/particle.h>
00034 
00035 #include <lescegra/sg/node.h>
00036 
00037 #include <lescegra/util/vertex.h>
00038 
00039 typedef LsgParticle* (*LsgParticleGenerator)(float time);
00040 
00041 /**
00042  * \ingroup particle
00043  * \brief   Constant source of new particles
00044  *
00045  * Constantly create new particles and wipe old ones while time elapses.
00046  */
00047 typedef struct {
00048     LsgParticleModifier super;
00049     LsgParticleGenerator generator;
00050     Vertex location;
00051     Vertex location_error;
00052     Vertex speed;
00053     Vertex speed_error;
00054     float birth_rate;
00055     float birth_rate_error;
00056     float lifetime;
00057     float lifetime_error;
00058     float time;
00059 } LsgParticleSource;
00060 
00061 LsgParticleSource* LsgParticleSource_create(LsgParticleGenerator generator, float now);
00062 void LsgParticleSource_init(LsgParticleSource* self, LsgParticleGenerator generator, float now);
00063 void LsgParticleSource_update(LsgParticleSource* self, LsgList* particles, float now);
00064 
00065 #define LsgParticleSource_destroy(self) LsgParticleModifier_destroy(&(self)->super)
00066 
00067 #endif