1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
/*
* Copyright (C) Volition, Inc. 1999. All rights reserved.
*
* All source code herein is the property of Volition, Inc. You may not sell
* or otherwise commercially exploit the source or things you created based on the
* source.
*
*/
#ifndef _PARTICLE_H
#define _PARTICLE_H
#include "globalincs/pstypes.h"
//#define MAX_PARTICLES 2000 // Reduced from 2000 to 800 by MK on 4/1/98. Most I ever saw was 400 and the system recovers
// gracefully from running out of slots.
// AP: Put it to 1500 on 4/15/98. Primary hit sparks weren't finding open slots.
// Made todo item for John to force oldest smoke particles to give up their slots.
// 06/05/24 - taylor - made it dynamic
//============================================================================
//==================== PARTICLE SYSTEM GAME SEQUENCING CODE ==================
//============================================================================
// Resets particle system. Call between levels.
void particle_init();
// called at game exit to cleanup any used resources
void particle_close();
// Moves the particles for each frame
void particle_move_all(float frametime);
// Renders all the particles
void particle_render_all();
// kill all active particles
void particle_kill_all();
//============================================================================
//=============== LOW-LEVEL SINGLE PARTICLE CREATION CODE ====================
//============================================================================
// The different types of particles...
#define PARTICLE_DEBUG 0 // A red sphere, no optional data required
#define PARTICLE_BITMAP 1 // A bitmap, optional data is the bitmap number. If bitmap is an animation,
// lifetime is calculated by the number of frames and fps.
#define PARTICLE_FIRE 2 // The vclip used for explosions, optional means nothing
#define PARTICLE_SMOKE 3 // The vclip used for smoke, optional means nothing
#define PARTICLE_SMOKE2 4 // The vclip used for smoke, optional means nothing
#define PARTICLE_BITMAP_PERSISTENT 5 // A bitmap, optional data is the bitmap number. If bitmap is an animation,
// lifetime is calculated by the number of frames and fps.
#define NUM_PARTICLE_TYPES 6
// particle creation stuff
typedef struct particle_info {
// old-style particle info
vec3d pos;
vec3d vel;
float lifetime;
float rad;
int type;
int optional_data;
// new-style particle info
float tracer_length;
int attached_objnum; // if these are set, the pos is relative to the pos of the origin of the attached object
int attached_sig; // to make sure the object hasn't changed or died. velocity is ignored in this case
ubyte reverse; // play any animations in reverse
} particle_info;
typedef struct particle {
// old style data
vec3d pos; // position
vec3d velocity; // velocity
float age; // How long it's been alive
float max_life; // How much life we had
float radius; // radius
int type; // type // -1 = None
int optional_data; // depends on type
int nframes; // If an ani, how many frames?
// new style data
float tracer_length; // if this is set, draw as a rod to simulate a "tracer" effect
int attached_objnum; // if this is set, pos is relative to the attached object. velocity is ignored
int attached_sig; // to check for dead/nonexistent objects
ubyte reverse; // play any animations in reverse
int particle_index; // used to keep particle offset in dynamic array for orient usage
uint signature;
} particle;
// Creates a single particle. See the PARTICLE_?? defines for types.
particle *particle_create( particle_info *pinfo );
particle *particle_create( vec3d *pos, vec3d *vel, float lifetime, float rad, int type, int optional_data = -1, float tracer_length=-1.0f, struct object *objp=NULL, bool reverse=false );
//============================================================================
//============== HIGH-LEVEL PARTICLE SYSTEM CREATION CODE ====================
//============================================================================
// Use a structure rather than pass a ton of parameters to particle_emit
typedef struct particle_emitter {
int num_low; // Lowest number of particles to create
int num_high; // Highest number of particles to create
vec3d pos; // Where the particles emit from
vec3d vel; // Initial velocity of all the particles
float min_life; // How long the particles live
float max_life; // How long the particles live
vec3d normal; // What normal the particle emit arond
float normal_variance; // How close they stick to that normal 0=good, 1=360 degree
float min_vel; // How fast the slowest particle can move
float max_vel; // How fast the fastest particle can move
float min_rad; // Min radius
float max_rad; // Max radius
} particle_emitter;
// Creates a bunch of particles. You pass a structure
// rather than a bunch of parameters.
void particle_emit( particle_emitter *pe, int type, int optional_data, float range=1.0 );
#endif // _PARTICLE_H
|
