aboutsummaryrefslogtreecommitdiff
path: root/src/crepe/api/ParticleEmitter.h
blob: cdea69a3992ae9e3b8919e2fb6264dabe726ab24 (plain)
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
#pragma once

#include <cmath>
#include <vector>

#include "Component.h"
#include "Particle.h"
#include "system/ParticleSystem.h"
#include "types.h"

namespace crepe {

class Sprite;

/**
 * \brief Data holder for particle emission parameters.
 *
 * The ParticleEmitter class stores configuration data for particle properties, defining the
 * characteristics and boundaries of particle emissions.
 */
class ParticleEmitter : public Component {
public:
	/**
	 * \brief Defines the boundary within which particles are constrained.
	 *
	 * This structure specifies the boundary's size and offset, as well as the behavior of
	 * particles upon reaching the boundary limits.
	 */
	struct Boundary {
		//! boundary width (midpoint is emitter location)
		float width = INFINITY;
		//! boundary height (midpoint is emitter location)
		float height = INFINITY;
		//! boundary offset from particle emitter location
		vec2 offset;
		//! reset on exit or stop velocity and set max postion
		bool reset_on_exit = false;
	};

	//! sprite reference of displayed sprite
	const Sprite & sprite;

	/**
	 * \brief Holds parameters that control particle emission.
	 *
	 * Contains settings for the emitter’s position, particle speed, angle, lifespan, boundary,
	 * and the sprite used for rendering particles.
	 */
	struct Data {
		//! position of the emitter
		vec2 position;
		//! maximum number of particles
		const unsigned int max_particles = 256;
		//! rate of particle emission per update (Lowest value = 0.001 any lower is ignored)
		float emission_rate = 1;
		//! min speed of the particles
		float min_speed = 1;
		//! min speed of the particles
		float max_speed = 2;
		//! min angle of particle emission
		float min_angle = 0;
		//! max angle of particle emission
		float max_angle = 0;
		//! begin Lifespan of particle (only visual)
		float begin_lifespan = 0.0;
		//! end Lifespan of particle
		float end_lifespan = 10.0;
		//! force over time (physics)
		vec2 force_over_time;
		//! particle boundary
		Boundary boundary;
		//! collection of particles
		std::vector<Particle> particles;
		
	};

public:
	/**
	 * \param game_object_id  Identifier for the game object using this emitter.
	 * \param data            Configuration data defining particle properties.
	 */
	ParticleEmitter(game_object_id_t game_object_id, const Sprite & sprite,const Data & data);

public:
	//! Configuration data for particle emission settings.
	Data data;
private:
	//! Saves time left over from last update event.
	friend ParticleSystem;
	float spawn_accumulator  = 0;
};

} // namespace crepe