simulate.md 1.87 KB
Newer Older
Hui Wang's avatar
Hui Wang committed
1
[[Home]](/docs/index.md)  [[User Guide]](/docs/guide/guide.md) [[Mesh Edit]](/docs/meshedit/overview.md) [[Path Tracer]](/docs/pathtracer/overview.md) [[Animation]](/docs/animation/overview.md)
2

Hui Wang's avatar
Hui Wang committed
3
---
4
5
# Simulate

allai5's avatar
allai5 committed
6
The simulation view provides a way to create and manage particle emitters. 
7

allai5's avatar
allai5 committed
8
To add an emitter, open the dropdown menu, adjust desired parameters, and press `Add`.
9

Hui Wang's avatar
Hui Wang committed
10
![add emitter](./simulate_mode/add_emitter.png)
11

allai5's avatar
allai5 committed
12
13
14
15
16
- Color: color with which to render the particles.
- Angle: angle of cone within which particles are generated (pointing in the emitter object's direction).
- Scale: the scale factor to apply to the particle mesh when rendering particles.
- Lifetime: how long (in seconds) each particle should live before it is deleted.
- Particles/Sec: how many particles should be generated per second. The total amount of live particles is hence `lifetime * particles_per_second`.
TheNumbat's avatar
TheNumbat committed
17
- Particle: choose the shape of each particle.  If mesh objects are present in the scene, they will also show up here, allowing the creation of particles with custom shapes!
allai5's avatar
allai5 committed
18
19
20
21
22
23
- Enabled: whether to immediately enable the emitter 

Once an enabled emitter is added to the scene (and animation task 4: particle simulation is implemented), particles will start generating and following trajectories based on the emitter parameters. Particles should collide with scene objects. When moving existing objects that particles interact with, the simulation will not be updated until the movement is completed. 

For example, the `particles.dae` test scene:

Hui Wang's avatar
Hui Wang committed
24
<video src="./simulate_mode/guide-simulate-1.mp4" controls preload muted loop style="max-width: 100%; margin: 0 auto;"></video>
Hui Wang's avatar
Hui Wang committed
25
![](./simulate_mode/guide-simulate-1.mp4)
allai5's avatar
allai5 committed
26

TheNumbat's avatar
TheNumbat committed
27
Finally, note that you can render particles just like any other scene objects. Rendering `particles.dae` with depth of field:
allai5's avatar
allai5 committed
28

Hui Wang's avatar
Hui Wang committed
29
![particles render](./simulate_mode/render.png)