particles_storage.cpp 76 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953
  1. /**************************************************************************/
  2. /* particles_storage.cpp */
  3. /**************************************************************************/
  4. /* This file is part of: */
  5. /* GODOT ENGINE */
  6. /* https://godotengine.org */
  7. /**************************************************************************/
  8. /* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
  9. /* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
  10. /* */
  11. /* Permission is hereby granted, free of charge, to any person obtaining */
  12. /* a copy of this software and associated documentation files (the */
  13. /* "Software"), to deal in the Software without restriction, including */
  14. /* without limitation the rights to use, copy, modify, merge, publish, */
  15. /* distribute, sublicense, and/or sell copies of the Software, and to */
  16. /* permit persons to whom the Software is furnished to do so, subject to */
  17. /* the following conditions: */
  18. /* */
  19. /* The above copyright notice and this permission notice shall be */
  20. /* included in all copies or substantial portions of the Software. */
  21. /* */
  22. /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
  23. /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
  24. /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
  25. /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
  26. /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
  27. /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
  28. /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
  29. /**************************************************************************/
  30. #include "particles_storage.h"
  31. #include "servers/rendering/renderer_rd/renderer_compositor_rd.h"
  32. #include "servers/rendering/rendering_server_globals.h"
  33. #include "texture_storage.h"
  34. using namespace RendererRD;
  35. ParticlesStorage *ParticlesStorage::singleton = nullptr;
  36. ParticlesStorage *ParticlesStorage::get_singleton() {
  37. return singleton;
  38. }
  39. ParticlesStorage::ParticlesStorage() {
  40. singleton = this;
  41. MaterialStorage *material_storage = MaterialStorage::get_singleton();
  42. /* Effects */
  43. sort_effects = memnew(SortEffects);
  44. /* Particles */
  45. {
  46. String defines = "#define SAMPLERS_BINDING_FIRST_INDEX " + itos(SAMPLERS_BINDING_FIRST_INDEX) + "\n";
  47. // Initialize particles
  48. Vector<String> particles_modes;
  49. particles_modes.push_back("");
  50. particles_shader.shader.initialize(particles_modes, defines);
  51. }
  52. MaterialStorage::get_singleton()->shader_set_data_request_function(MaterialStorage::SHADER_TYPE_PARTICLES, _create_particles_shader_funcs);
  53. MaterialStorage::get_singleton()->material_set_data_request_function(MaterialStorage::SHADER_TYPE_PARTICLES, _create_particles_material_funcs);
  54. {
  55. ShaderCompiler::DefaultIdentifierActions actions;
  56. actions.renames["COLOR"] = "PARTICLE.color";
  57. actions.renames["VELOCITY"] = "PARTICLE.velocity";
  58. //actions.renames["MASS"] = "mass"; ?
  59. actions.renames["ACTIVE"] = "particle_active";
  60. actions.renames["RESTART"] = "restart";
  61. actions.renames["CUSTOM"] = "PARTICLE.custom";
  62. actions.renames["AMOUNT_RATIO"] = "FRAME.amount_ratio";
  63. for (int i = 0; i < ParticlesShader::MAX_USERDATAS; i++) {
  64. String udname = "USERDATA" + itos(i + 1);
  65. actions.renames[udname] = "PARTICLE.userdata" + itos(i + 1);
  66. actions.usage_defines[udname] = "#define USERDATA" + itos(i + 1) + "_USED\n";
  67. }
  68. actions.renames["TRANSFORM"] = "PARTICLE.xform";
  69. actions.renames["TIME"] = "frame_history.data[0].time";
  70. actions.renames["PI"] = _MKSTR(Math_PI);
  71. actions.renames["TAU"] = _MKSTR(Math_TAU);
  72. actions.renames["E"] = _MKSTR(Math_E);
  73. actions.renames["LIFETIME"] = "params.lifetime";
  74. actions.renames["DELTA"] = "local_delta";
  75. actions.renames["NUMBER"] = "particle_number";
  76. actions.renames["INDEX"] = "index";
  77. //actions.renames["GRAVITY"] = "current_gravity";
  78. actions.renames["EMISSION_TRANSFORM"] = "FRAME.emission_transform";
  79. actions.renames["EMITTER_VELOCITY"] = "FRAME.emitter_velocity";
  80. actions.renames["INTERPOLATE_TO_END"] = "FRAME.interp_to_end";
  81. actions.renames["RANDOM_SEED"] = "FRAME.random_seed";
  82. actions.renames["FLAG_EMIT_POSITION"] = "EMISSION_FLAG_HAS_POSITION";
  83. actions.renames["FLAG_EMIT_ROT_SCALE"] = "EMISSION_FLAG_HAS_ROTATION_SCALE";
  84. actions.renames["FLAG_EMIT_VELOCITY"] = "EMISSION_FLAG_HAS_VELOCITY";
  85. actions.renames["FLAG_EMIT_COLOR"] = "EMISSION_FLAG_HAS_COLOR";
  86. actions.renames["FLAG_EMIT_CUSTOM"] = "EMISSION_FLAG_HAS_CUSTOM";
  87. actions.renames["RESTART_POSITION"] = "restart_position";
  88. actions.renames["RESTART_ROT_SCALE"] = "restart_rotation_scale";
  89. actions.renames["RESTART_VELOCITY"] = "restart_velocity";
  90. actions.renames["RESTART_COLOR"] = "restart_color";
  91. actions.renames["RESTART_CUSTOM"] = "restart_custom";
  92. actions.renames["emit_subparticle"] = "emit_subparticle";
  93. actions.renames["COLLIDED"] = "collided";
  94. actions.renames["COLLISION_NORMAL"] = "collision_normal";
  95. actions.renames["COLLISION_DEPTH"] = "collision_depth";
  96. actions.renames["ATTRACTOR_FORCE"] = "attractor_force";
  97. actions.render_mode_defines["disable_force"] = "#define DISABLE_FORCE\n";
  98. actions.render_mode_defines["disable_velocity"] = "#define DISABLE_VELOCITY\n";
  99. actions.render_mode_defines["keep_data"] = "#define ENABLE_KEEP_DATA\n";
  100. actions.render_mode_defines["collision_use_scale"] = "#define USE_COLLISION_SCALE\n";
  101. actions.base_texture_binding_index = 1;
  102. actions.texture_layout_set = 3;
  103. actions.base_uniform_string = "material.";
  104. actions.base_varying_index = 10;
  105. actions.default_filter = ShaderLanguage::FILTER_LINEAR_MIPMAP;
  106. actions.default_repeat = ShaderLanguage::REPEAT_ENABLE;
  107. actions.global_buffer_array_variable = "global_shader_uniforms.data";
  108. particles_shader.compiler.initialize(actions);
  109. }
  110. {
  111. // default material and shader for particles shader
  112. particles_shader.default_shader = material_storage->shader_allocate();
  113. material_storage->shader_initialize(particles_shader.default_shader);
  114. material_storage->shader_set_code(particles_shader.default_shader, R"(
  115. // Default particles shader.
  116. shader_type particles;
  117. void process() {
  118. COLOR = vec4(1.0);
  119. }
  120. )");
  121. particles_shader.default_material = material_storage->material_allocate();
  122. material_storage->material_initialize(particles_shader.default_material);
  123. material_storage->material_set_shader(particles_shader.default_material, particles_shader.default_shader);
  124. ParticleProcessMaterialData *md = static_cast<ParticleProcessMaterialData *>(material_storage->material_get_data(particles_shader.default_material, MaterialStorage::SHADER_TYPE_PARTICLES));
  125. particles_shader.default_shader_rd = particles_shader.shader.version_get_shader(md->shader_data->version, 0);
  126. Vector<RD::Uniform> uniforms;
  127. {
  128. RD::Uniform u;
  129. u.uniform_type = RD::UNIFORM_TYPE_STORAGE_BUFFER;
  130. u.binding = 2;
  131. u.append_id(material_storage->global_shader_uniforms_get_storage_buffer());
  132. uniforms.push_back(u);
  133. }
  134. uniforms.append_array(material_storage->samplers_rd_get_default().get_uniforms(SAMPLERS_BINDING_FIRST_INDEX));
  135. particles_shader.base_uniform_set = RD::get_singleton()->uniform_set_create(uniforms, particles_shader.default_shader_rd, BASE_UNIFORM_SET);
  136. }
  137. {
  138. Vector<String> copy_modes;
  139. for (int i = 0; i <= ParticlesShader::MAX_USERDATAS; i++) {
  140. if (i == 0) {
  141. copy_modes.push_back("\n#define MODE_FILL_INSTANCES\n");
  142. copy_modes.push_back("\n#define MODE_FILL_SORT_BUFFER\n#define USE_SORT_BUFFER\n");
  143. copy_modes.push_back("\n#define MODE_FILL_INSTANCES\n#define USE_SORT_BUFFER\n");
  144. } else {
  145. copy_modes.push_back("\n#define MODE_FILL_INSTANCES\n#define USERDATA_COUNT " + itos(i) + "\n");
  146. copy_modes.push_back("\n#define MODE_FILL_SORT_BUFFER\n#define USE_SORT_BUFFER\n#define USERDATA_COUNT " + itos(i) + "\n");
  147. copy_modes.push_back("\n#define MODE_FILL_INSTANCES\n#define USE_SORT_BUFFER\n#define USERDATA_COUNT " + itos(i) + "\n");
  148. }
  149. }
  150. particles_shader.copy_shader.initialize(copy_modes);
  151. particles_shader.copy_shader_version = particles_shader.copy_shader.version_create();
  152. for (int i = 0; i <= ParticlesShader::MAX_USERDATAS; i++) {
  153. for (int j = 0; j < ParticlesShader::COPY_MODE_MAX; j++) {
  154. particles_shader.copy_pipelines[i * ParticlesShader::COPY_MODE_MAX + j] = RD::get_singleton()->compute_pipeline_create(particles_shader.copy_shader.version_get_shader(particles_shader.copy_shader_version, i * ParticlesShader::COPY_MODE_MAX + j));
  155. }
  156. }
  157. }
  158. }
  159. ParticlesStorage::~ParticlesStorage() {
  160. MaterialStorage *material_storage = MaterialStorage::get_singleton();
  161. particles_shader.copy_shader.version_free(particles_shader.copy_shader_version);
  162. material_storage->material_free(particles_shader.default_material);
  163. material_storage->shader_free(particles_shader.default_shader);
  164. if (sort_effects) {
  165. memdelete(sort_effects);
  166. sort_effects = nullptr;
  167. }
  168. singleton = nullptr;
  169. }
  170. bool ParticlesStorage::free(RID p_rid) {
  171. if (owns_particles(p_rid)) {
  172. particles_free(p_rid);
  173. return true;
  174. } else if (owns_particles_collision(p_rid)) {
  175. particles_collision_free(p_rid);
  176. return true;
  177. } else if (owns_particles_collision_instance(p_rid)) {
  178. particles_collision_instance_free(p_rid);
  179. return true;
  180. }
  181. return false;
  182. }
  183. /* PARTICLES */
  184. RID ParticlesStorage::particles_allocate() {
  185. return particles_owner.allocate_rid();
  186. }
  187. void ParticlesStorage::particles_initialize(RID p_rid) {
  188. particles_owner.initialize_rid(p_rid);
  189. }
  190. void ParticlesStorage::particles_free(RID p_rid) {
  191. Particles *particles = particles_owner.get_or_null(p_rid);
  192. particles->dependency.deleted_notify(p_rid);
  193. particles->update_list.remove_from_list();
  194. _particles_free_data(particles);
  195. particles_owner.free(p_rid);
  196. }
  197. void ParticlesStorage::particles_set_mode(RID p_particles, RS::ParticlesMode p_mode) {
  198. Particles *particles = particles_owner.get_or_null(p_particles);
  199. ERR_FAIL_NULL(particles);
  200. if (particles->mode == p_mode) {
  201. return;
  202. }
  203. _particles_free_data(particles);
  204. particles->mode = p_mode;
  205. }
  206. void ParticlesStorage::particles_set_emitting(RID p_particles, bool p_emitting) {
  207. Particles *particles = particles_owner.get_or_null(p_particles);
  208. ERR_FAIL_NULL(particles);
  209. particles->emitting = p_emitting;
  210. }
  211. bool ParticlesStorage::particles_get_emitting(RID p_particles) {
  212. ERR_FAIL_COND_V_MSG(RSG::threaded, false, "This function should never be used with threaded rendering, as it stalls the renderer.");
  213. Particles *particles = particles_owner.get_or_null(p_particles);
  214. ERR_FAIL_NULL_V(particles, false);
  215. return particles->emitting;
  216. }
  217. void ParticlesStorage::_particles_free_data(Particles *particles) {
  218. if (particles->particle_buffer.is_valid()) {
  219. RD::get_singleton()->free(particles->particle_buffer);
  220. particles->particle_buffer = RID();
  221. RD::get_singleton()->free(particles->particle_instance_buffer);
  222. particles->particle_instance_buffer = RID();
  223. }
  224. particles->userdata_count = 0;
  225. if (particles->frame_params_buffer.is_valid()) {
  226. RD::get_singleton()->free(particles->frame_params_buffer);
  227. particles->frame_params_buffer = RID();
  228. }
  229. particles->particles_transforms_buffer_uniform_set = RID();
  230. if (RD::get_singleton()->uniform_set_is_valid(particles->trail_bind_pose_uniform_set)) {
  231. RD::get_singleton()->free(particles->trail_bind_pose_uniform_set);
  232. }
  233. particles->trail_bind_pose_uniform_set = RID();
  234. if (particles->trail_bind_pose_buffer.is_valid()) {
  235. RD::get_singleton()->free(particles->trail_bind_pose_buffer);
  236. particles->trail_bind_pose_buffer = RID();
  237. }
  238. if (RD::get_singleton()->uniform_set_is_valid(particles->collision_textures_uniform_set)) {
  239. RD::get_singleton()->free(particles->collision_textures_uniform_set);
  240. }
  241. particles->collision_textures_uniform_set = RID();
  242. if (particles->particles_sort_buffer.is_valid()) {
  243. RD::get_singleton()->free(particles->particles_sort_buffer);
  244. particles->particles_sort_buffer = RID();
  245. particles->particles_sort_uniform_set = RID();
  246. }
  247. if (particles->emission_buffer != nullptr) {
  248. particles->emission_buffer = nullptr;
  249. particles->emission_buffer_data.clear();
  250. RD::get_singleton()->free(particles->emission_storage_buffer);
  251. particles->emission_storage_buffer = RID();
  252. }
  253. if (particles->unused_storage_buffer.is_valid()) {
  254. RD::get_singleton()->free(particles->unused_storage_buffer);
  255. particles->unused_storage_buffer = RID();
  256. }
  257. if (RD::get_singleton()->uniform_set_is_valid(particles->particles_material_uniform_set)) {
  258. //will need to be re-created
  259. RD::get_singleton()->free(particles->particles_material_uniform_set);
  260. }
  261. particles->particles_material_uniform_set = RID();
  262. }
  263. void ParticlesStorage::particles_set_amount(RID p_particles, int p_amount) {
  264. Particles *particles = particles_owner.get_or_null(p_particles);
  265. ERR_FAIL_NULL(particles);
  266. if (particles->amount == p_amount) {
  267. return;
  268. }
  269. _particles_free_data(particles);
  270. particles->amount = p_amount;
  271. particles->prev_ticks = 0;
  272. particles->phase = 0;
  273. particles->prev_phase = 0;
  274. particles->clear = true;
  275. particles->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_PARTICLES);
  276. }
  277. void ParticlesStorage::particles_set_amount_ratio(RID p_particles, float p_amount_ratio) {
  278. Particles *particles = particles_owner.get_or_null(p_particles);
  279. ERR_FAIL_NULL(particles);
  280. particles->amount_ratio = p_amount_ratio;
  281. }
  282. void ParticlesStorage::particles_set_lifetime(RID p_particles, double p_lifetime) {
  283. Particles *particles = particles_owner.get_or_null(p_particles);
  284. ERR_FAIL_NULL(particles);
  285. particles->lifetime = p_lifetime;
  286. }
  287. void ParticlesStorage::particles_set_one_shot(RID p_particles, bool p_one_shot) {
  288. Particles *particles = particles_owner.get_or_null(p_particles);
  289. ERR_FAIL_NULL(particles);
  290. particles->one_shot = p_one_shot;
  291. }
  292. void ParticlesStorage::particles_set_pre_process_time(RID p_particles, double p_time) {
  293. Particles *particles = particles_owner.get_or_null(p_particles);
  294. ERR_FAIL_NULL(particles);
  295. particles->pre_process_time = p_time;
  296. }
  297. void ParticlesStorage::particles_set_explosiveness_ratio(RID p_particles, real_t p_ratio) {
  298. Particles *particles = particles_owner.get_or_null(p_particles);
  299. ERR_FAIL_NULL(particles);
  300. particles->explosiveness = p_ratio;
  301. }
  302. void ParticlesStorage::particles_set_randomness_ratio(RID p_particles, real_t p_ratio) {
  303. Particles *particles = particles_owner.get_or_null(p_particles);
  304. ERR_FAIL_NULL(particles);
  305. particles->randomness = p_ratio;
  306. }
  307. void ParticlesStorage::particles_set_custom_aabb(RID p_particles, const AABB &p_aabb) {
  308. Particles *particles = particles_owner.get_or_null(p_particles);
  309. ERR_FAIL_NULL(particles);
  310. particles->custom_aabb = p_aabb;
  311. particles->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_AABB);
  312. }
  313. void ParticlesStorage::particles_set_speed_scale(RID p_particles, double p_scale) {
  314. Particles *particles = particles_owner.get_or_null(p_particles);
  315. ERR_FAIL_NULL(particles);
  316. particles->speed_scale = p_scale;
  317. }
  318. void ParticlesStorage::particles_set_use_local_coordinates(RID p_particles, bool p_enable) {
  319. Particles *particles = particles_owner.get_or_null(p_particles);
  320. ERR_FAIL_NULL(particles);
  321. particles->use_local_coords = p_enable;
  322. particles->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_PARTICLES);
  323. }
  324. void ParticlesStorage::particles_set_fixed_fps(RID p_particles, int p_fps) {
  325. Particles *particles = particles_owner.get_or_null(p_particles);
  326. ERR_FAIL_NULL(particles);
  327. particles->fixed_fps = p_fps;
  328. _particles_free_data(particles);
  329. particles->prev_ticks = 0;
  330. particles->phase = 0;
  331. particles->prev_phase = 0;
  332. particles->clear = true;
  333. particles->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_PARTICLES);
  334. }
  335. void ParticlesStorage::particles_set_interpolate(RID p_particles, bool p_enable) {
  336. Particles *particles = particles_owner.get_or_null(p_particles);
  337. ERR_FAIL_NULL(particles);
  338. particles->interpolate = p_enable;
  339. }
  340. void ParticlesStorage::particles_set_fractional_delta(RID p_particles, bool p_enable) {
  341. Particles *particles = particles_owner.get_or_null(p_particles);
  342. ERR_FAIL_NULL(particles);
  343. particles->fractional_delta = p_enable;
  344. }
  345. void ParticlesStorage::particles_set_trails(RID p_particles, bool p_enable, double p_length) {
  346. Particles *particles = particles_owner.get_or_null(p_particles);
  347. ERR_FAIL_NULL(particles);
  348. ERR_FAIL_COND(p_length < 0.01);
  349. p_length = MIN(10.0, p_length);
  350. particles->trails_enabled = p_enable;
  351. particles->trail_lifetime = p_length;
  352. _particles_free_data(particles);
  353. particles->prev_ticks = 0;
  354. particles->phase = 0;
  355. particles->prev_phase = 0;
  356. particles->clear = true;
  357. particles->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_PARTICLES);
  358. }
  359. void ParticlesStorage::particles_set_trail_bind_poses(RID p_particles, const Vector<Transform3D> &p_bind_poses) {
  360. Particles *particles = particles_owner.get_or_null(p_particles);
  361. ERR_FAIL_NULL(particles);
  362. if (particles->trail_bind_pose_buffer.is_valid() && particles->trail_bind_poses.size() != p_bind_poses.size()) {
  363. _particles_free_data(particles);
  364. particles->prev_ticks = 0;
  365. particles->phase = 0;
  366. particles->prev_phase = 0;
  367. particles->clear = true;
  368. }
  369. particles->trail_bind_poses = p_bind_poses;
  370. particles->trail_bind_poses_dirty = true;
  371. particles->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_PARTICLES);
  372. }
  373. void ParticlesStorage::particles_set_collision_base_size(RID p_particles, real_t p_size) {
  374. Particles *particles = particles_owner.get_or_null(p_particles);
  375. ERR_FAIL_NULL(particles);
  376. particles->collision_base_size = p_size;
  377. }
  378. void ParticlesStorage::particles_set_transform_align(RID p_particles, RS::ParticlesTransformAlign p_transform_align) {
  379. Particles *particles = particles_owner.get_or_null(p_particles);
  380. ERR_FAIL_NULL(particles);
  381. particles->transform_align = p_transform_align;
  382. }
  383. void ParticlesStorage::particles_set_process_material(RID p_particles, RID p_material) {
  384. Particles *particles = particles_owner.get_or_null(p_particles);
  385. ERR_FAIL_NULL(particles);
  386. particles->process_material = p_material;
  387. particles->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_PARTICLES); //the instance buffer may have changed
  388. }
  389. RID ParticlesStorage::particles_get_process_material(RID p_particles) const {
  390. Particles *particles = particles_owner.get_or_null(p_particles);
  391. ERR_FAIL_NULL_V(particles, RID());
  392. return particles->process_material;
  393. }
  394. void ParticlesStorage::particles_set_draw_order(RID p_particles, RS::ParticlesDrawOrder p_order) {
  395. Particles *particles = particles_owner.get_or_null(p_particles);
  396. ERR_FAIL_NULL(particles);
  397. particles->draw_order = p_order;
  398. }
  399. void ParticlesStorage::particles_set_draw_passes(RID p_particles, int p_passes) {
  400. Particles *particles = particles_owner.get_or_null(p_particles);
  401. ERR_FAIL_NULL(particles);
  402. particles->draw_passes.resize(p_passes);
  403. }
  404. void ParticlesStorage::particles_set_draw_pass_mesh(RID p_particles, int p_pass, RID p_mesh) {
  405. Particles *particles = particles_owner.get_or_null(p_particles);
  406. ERR_FAIL_NULL(particles);
  407. ERR_FAIL_INDEX(p_pass, particles->draw_passes.size());
  408. particles->draw_passes.write[p_pass] = p_mesh;
  409. }
  410. void ParticlesStorage::particles_restart(RID p_particles) {
  411. Particles *particles = particles_owner.get_or_null(p_particles);
  412. ERR_FAIL_NULL(particles);
  413. particles->restart_request = true;
  414. }
  415. void ParticlesStorage::_particles_allocate_emission_buffer(Particles *particles) {
  416. ERR_FAIL_COND(particles->emission_buffer != nullptr);
  417. particles->emission_buffer_data.resize(sizeof(ParticleEmissionBuffer::Data) * particles->amount + sizeof(uint32_t) * 4);
  418. memset(particles->emission_buffer_data.ptrw(), 0, particles->emission_buffer_data.size());
  419. particles->emission_buffer = reinterpret_cast<ParticleEmissionBuffer *>(particles->emission_buffer_data.ptrw());
  420. particles->emission_buffer->particle_max = particles->amount;
  421. particles->emission_storage_buffer = RD::get_singleton()->storage_buffer_create(particles->emission_buffer_data.size(), particles->emission_buffer_data);
  422. if (RD::get_singleton()->uniform_set_is_valid(particles->particles_material_uniform_set)) {
  423. //will need to be re-created
  424. RD::get_singleton()->free(particles->particles_material_uniform_set);
  425. particles->particles_material_uniform_set = RID();
  426. }
  427. }
  428. void ParticlesStorage::_particles_ensure_unused_buffer(Particles *particles) {
  429. if (particles->unused_storage_buffer.is_null()) {
  430. particles->unused_storage_buffer = RD::get_singleton()->storage_buffer_create(sizeof(uint32_t) * 4);
  431. }
  432. }
  433. void ParticlesStorage::particles_set_subemitter(RID p_particles, RID p_subemitter_particles) {
  434. Particles *particles = particles_owner.get_or_null(p_particles);
  435. ERR_FAIL_NULL(particles);
  436. ERR_FAIL_COND(p_particles == p_subemitter_particles);
  437. particles->sub_emitter = p_subemitter_particles;
  438. if (RD::get_singleton()->uniform_set_is_valid(particles->particles_material_uniform_set)) {
  439. RD::get_singleton()->free(particles->particles_material_uniform_set);
  440. particles->particles_material_uniform_set = RID(); //clear and force to re create sub emitting
  441. }
  442. }
  443. void ParticlesStorage::particles_emit(RID p_particles, const Transform3D &p_transform, const Vector3 &p_velocity, const Color &p_color, const Color &p_custom, uint32_t p_emit_flags) {
  444. Particles *particles = particles_owner.get_or_null(p_particles);
  445. ERR_FAIL_NULL(particles);
  446. ERR_FAIL_COND(particles->amount == 0);
  447. if (particles->emitting) {
  448. particles->clear = true;
  449. particles->emitting = false;
  450. }
  451. if (particles->emission_buffer == nullptr) {
  452. _particles_allocate_emission_buffer(particles);
  453. }
  454. particles->inactive = false;
  455. particles->inactive_time = 0;
  456. int32_t idx = particles->emission_buffer->particle_count;
  457. if (idx < particles->emission_buffer->particle_max) {
  458. RendererRD::MaterialStorage::store_transform(p_transform, particles->emission_buffer->data[idx].xform);
  459. particles->emission_buffer->data[idx].velocity[0] = p_velocity.x;
  460. particles->emission_buffer->data[idx].velocity[1] = p_velocity.y;
  461. particles->emission_buffer->data[idx].velocity[2] = p_velocity.z;
  462. particles->emission_buffer->data[idx].custom[0] = p_custom.r;
  463. particles->emission_buffer->data[idx].custom[1] = p_custom.g;
  464. particles->emission_buffer->data[idx].custom[2] = p_custom.b;
  465. particles->emission_buffer->data[idx].custom[3] = p_custom.a;
  466. particles->emission_buffer->data[idx].color[0] = p_color.r;
  467. particles->emission_buffer->data[idx].color[1] = p_color.g;
  468. particles->emission_buffer->data[idx].color[2] = p_color.b;
  469. particles->emission_buffer->data[idx].color[3] = p_color.a;
  470. particles->emission_buffer->data[idx].flags = p_emit_flags;
  471. particles->emission_buffer->particle_count++;
  472. }
  473. }
  474. void ParticlesStorage::particles_request_process(RID p_particles) {
  475. Particles *particles = particles_owner.get_or_null(p_particles);
  476. ERR_FAIL_NULL(particles);
  477. if (!particles->dirty) {
  478. particles->dirty = true;
  479. if (!particles->update_list.in_list()) {
  480. particle_update_list.add(&particles->update_list);
  481. }
  482. }
  483. }
  484. AABB ParticlesStorage::particles_get_current_aabb(RID p_particles) {
  485. if (RSG::threaded) {
  486. WARN_PRINT_ONCE("Calling this function with threaded rendering enabled stalls the renderer, use with care.");
  487. }
  488. const Particles *particles = particles_owner.get_or_null(p_particles);
  489. ERR_FAIL_NULL_V(particles, AABB());
  490. int total_amount = particles->amount;
  491. if (particles->trails_enabled && particles->trail_bind_poses.size() > 1) {
  492. total_amount *= particles->trail_bind_poses.size();
  493. }
  494. Vector<uint8_t> buffer = RD::get_singleton()->buffer_get_data(particles->particle_buffer);
  495. ERR_FAIL_COND_V(buffer.size() != (int)(total_amount * sizeof(ParticleData)), AABB());
  496. Transform3D inv = particles->emission_transform.affine_inverse();
  497. AABB aabb;
  498. if (buffer.size()) {
  499. bool first = true;
  500. const uint8_t *data_ptr = (const uint8_t *)buffer.ptr();
  501. uint32_t particle_data_size = sizeof(ParticleData) + sizeof(float) * particles->userdata_count;
  502. for (int i = 0; i < total_amount; i++) {
  503. const ParticleData &particle_data = *(const ParticleData *)&data_ptr[particle_data_size * i];
  504. if (particle_data.active) {
  505. Vector3 pos = Vector3(particle_data.xform[12], particle_data.xform[13], particle_data.xform[14]);
  506. if (!particles->use_local_coords) {
  507. pos = inv.xform(pos);
  508. }
  509. if (first) {
  510. aabb.position = pos;
  511. first = false;
  512. } else {
  513. aabb.expand_to(pos);
  514. }
  515. }
  516. }
  517. }
  518. float longest_axis_size = 0;
  519. for (int i = 0; i < particles->draw_passes.size(); i++) {
  520. if (particles->draw_passes[i].is_valid()) {
  521. AABB maabb = MeshStorage::get_singleton()->mesh_get_aabb(particles->draw_passes[i], RID());
  522. longest_axis_size = MAX(maabb.get_longest_axis_size(), longest_axis_size);
  523. }
  524. }
  525. aabb.grow_by(longest_axis_size);
  526. return aabb;
  527. }
  528. AABB ParticlesStorage::particles_get_aabb(RID p_particles) const {
  529. const Particles *particles = particles_owner.get_or_null(p_particles);
  530. ERR_FAIL_NULL_V(particles, AABB());
  531. return particles->custom_aabb;
  532. }
  533. void ParticlesStorage::particles_set_emission_transform(RID p_particles, const Transform3D &p_transform) {
  534. Particles *particles = particles_owner.get_or_null(p_particles);
  535. ERR_FAIL_NULL(particles);
  536. particles->emission_transform = p_transform;
  537. }
  538. void ParticlesStorage::particles_set_emitter_velocity(RID p_particles, const Vector3 &p_velocity) {
  539. Particles *particles = particles_owner.get_or_null(p_particles);
  540. ERR_FAIL_NULL(particles);
  541. particles->emitter_velocity = p_velocity;
  542. }
  543. void ParticlesStorage::particles_set_interp_to_end(RID p_particles, float p_interp) {
  544. Particles *particles = particles_owner.get_or_null(p_particles);
  545. ERR_FAIL_NULL(particles);
  546. particles->interp_to_end = p_interp;
  547. }
  548. int ParticlesStorage::particles_get_draw_passes(RID p_particles) const {
  549. const Particles *particles = particles_owner.get_or_null(p_particles);
  550. ERR_FAIL_NULL_V(particles, 0);
  551. return particles->draw_passes.size();
  552. }
  553. RID ParticlesStorage::particles_get_draw_pass_mesh(RID p_particles, int p_pass) const {
  554. const Particles *particles = particles_owner.get_or_null(p_particles);
  555. ERR_FAIL_NULL_V(particles, RID());
  556. ERR_FAIL_INDEX_V(p_pass, particles->draw_passes.size(), RID());
  557. return particles->draw_passes[p_pass];
  558. }
  559. void ParticlesStorage::particles_update_dependency(RID p_particles, DependencyTracker *p_instance) {
  560. Particles *particles = particles_owner.get_or_null(p_particles);
  561. ERR_FAIL_NULL(particles);
  562. p_instance->update_dependency(&particles->dependency);
  563. }
  564. void ParticlesStorage::particles_get_instance_buffer_motion_vectors_offsets(RID p_particles, uint32_t &r_current_offset, uint32_t &r_prev_offset) {
  565. Particles *particles = particles_owner.get_or_null(p_particles);
  566. ERR_FAIL_NULL(particles);
  567. r_current_offset = particles->instance_motion_vectors_current_offset;
  568. r_prev_offset = particles->instance_motion_vectors_previous_offset;
  569. }
  570. void ParticlesStorage::particles_add_collision(RID p_particles, RID p_particles_collision_instance) {
  571. Particles *particles = particles_owner.get_or_null(p_particles);
  572. ERR_FAIL_NULL(particles);
  573. particles->collisions.insert(p_particles_collision_instance);
  574. }
  575. void ParticlesStorage::particles_remove_collision(RID p_particles, RID p_particles_collision_instance) {
  576. Particles *particles = particles_owner.get_or_null(p_particles);
  577. ERR_FAIL_NULL(particles);
  578. particles->collisions.erase(p_particles_collision_instance);
  579. }
  580. void ParticlesStorage::particles_set_canvas_sdf_collision(RID p_particles, bool p_enable, const Transform2D &p_xform, const Rect2 &p_to_screen, RID p_texture) {
  581. Particles *particles = particles_owner.get_or_null(p_particles);
  582. ERR_FAIL_NULL(particles);
  583. particles->has_sdf_collision = p_enable;
  584. particles->sdf_collision_transform = p_xform;
  585. particles->sdf_collision_to_screen = p_to_screen;
  586. particles->sdf_collision_texture = p_texture;
  587. }
  588. void ParticlesStorage::_particles_process(Particles *p_particles, double p_delta) {
  589. TextureStorage *texture_storage = TextureStorage::get_singleton();
  590. MaterialStorage *material_storage = MaterialStorage::get_singleton();
  591. if (p_particles->particles_material_uniform_set.is_null() || !RD::get_singleton()->uniform_set_is_valid(p_particles->particles_material_uniform_set)) {
  592. Vector<RD::Uniform> uniforms;
  593. {
  594. RD::Uniform u;
  595. u.uniform_type = RD::UNIFORM_TYPE_STORAGE_BUFFER;
  596. u.binding = 0;
  597. u.append_id(p_particles->frame_params_buffer);
  598. uniforms.push_back(u);
  599. }
  600. {
  601. RD::Uniform u;
  602. u.uniform_type = RD::UNIFORM_TYPE_STORAGE_BUFFER;
  603. u.binding = 1;
  604. u.append_id(p_particles->particle_buffer);
  605. uniforms.push_back(u);
  606. }
  607. {
  608. RD::Uniform u;
  609. u.uniform_type = RD::UNIFORM_TYPE_STORAGE_BUFFER;
  610. u.binding = 2;
  611. if (p_particles->emission_storage_buffer.is_valid()) {
  612. u.append_id(p_particles->emission_storage_buffer);
  613. } else {
  614. _particles_ensure_unused_buffer(p_particles);
  615. u.append_id(p_particles->unused_storage_buffer);
  616. }
  617. uniforms.push_back(u);
  618. }
  619. {
  620. RD::Uniform u;
  621. u.uniform_type = RD::UNIFORM_TYPE_STORAGE_BUFFER;
  622. u.binding = 3;
  623. Particles *sub_emitter = particles_owner.get_or_null(p_particles->sub_emitter);
  624. if (sub_emitter) {
  625. if (sub_emitter->emission_buffer == nullptr) { //no emission buffer, allocate emission buffer
  626. _particles_allocate_emission_buffer(sub_emitter);
  627. }
  628. u.append_id(sub_emitter->emission_storage_buffer);
  629. } else {
  630. _particles_ensure_unused_buffer(p_particles);
  631. u.append_id(p_particles->unused_storage_buffer);
  632. }
  633. uniforms.push_back(u);
  634. }
  635. p_particles->particles_material_uniform_set = RD::get_singleton()->uniform_set_create(uniforms, particles_shader.default_shader_rd, 1);
  636. }
  637. double new_phase = Math::fmod((double)p_particles->phase + (p_delta / p_particles->lifetime) * p_particles->speed_scale, 1.0);
  638. //move back history (if there is any)
  639. for (uint32_t i = p_particles->frame_history.size() - 1; i > 0; i--) {
  640. p_particles->frame_history[i] = p_particles->frame_history[i - 1];
  641. }
  642. //update current frame
  643. ParticlesFrameParams &frame_params = p_particles->frame_history[0];
  644. if (p_particles->clear) {
  645. p_particles->cycle_number = 0;
  646. p_particles->random_seed = Math::rand();
  647. } else if (new_phase < p_particles->phase) {
  648. if (p_particles->one_shot) {
  649. p_particles->emitting = false;
  650. }
  651. p_particles->cycle_number++;
  652. }
  653. frame_params.emitting = p_particles->emitting;
  654. frame_params.system_phase = new_phase;
  655. frame_params.prev_system_phase = p_particles->phase;
  656. p_particles->phase = new_phase;
  657. frame_params.time = RendererCompositorRD::get_singleton()->get_total_time();
  658. frame_params.delta = p_delta * p_particles->speed_scale;
  659. frame_params.random_seed = p_particles->random_seed;
  660. frame_params.explosiveness = p_particles->explosiveness;
  661. frame_params.randomness = p_particles->randomness;
  662. if (p_particles->use_local_coords) {
  663. RendererRD::MaterialStorage::store_transform(Transform3D(), frame_params.emission_transform);
  664. } else {
  665. RendererRD::MaterialStorage::store_transform(p_particles->emission_transform, frame_params.emission_transform);
  666. }
  667. frame_params.cycle = p_particles->cycle_number;
  668. frame_params.frame = p_particles->frame_counter++;
  669. frame_params.amount_ratio = p_particles->amount_ratio;
  670. frame_params.pad1 = 0;
  671. frame_params.pad2 = 0;
  672. frame_params.emitter_velocity[0] = p_particles->emitter_velocity.x;
  673. frame_params.emitter_velocity[1] = p_particles->emitter_velocity.y;
  674. frame_params.emitter_velocity[2] = p_particles->emitter_velocity.z;
  675. frame_params.interp_to_end = p_particles->interp_to_end;
  676. { //collision and attractors
  677. frame_params.collider_count = 0;
  678. frame_params.attractor_count = 0;
  679. frame_params.particle_size = p_particles->collision_base_size;
  680. RID collision_3d_textures[ParticlesFrameParams::MAX_3D_TEXTURES];
  681. RID collision_heightmap_texture;
  682. Transform3D to_particles;
  683. if (p_particles->use_local_coords) {
  684. to_particles = p_particles->emission_transform.affine_inverse();
  685. }
  686. if (p_particles->has_sdf_collision && RD::get_singleton()->texture_is_valid(p_particles->sdf_collision_texture)) {
  687. //2D collision
  688. Transform2D xform = p_particles->sdf_collision_transform; //will use dotproduct manually so invert beforehand
  689. if (!p_particles->use_local_coords) {
  690. Transform2D emission;
  691. emission.columns[0] = Vector2(p_particles->emission_transform.basis.get_column(0).x, p_particles->emission_transform.basis.get_column(0).y);
  692. emission.columns[1] = Vector2(p_particles->emission_transform.basis.get_column(1).x, p_particles->emission_transform.basis.get_column(1).y);
  693. emission.set_origin(Vector2(p_particles->emission_transform.origin.x, p_particles->emission_transform.origin.y));
  694. xform = xform * emission.affine_inverse();
  695. }
  696. Transform2D revert = xform.affine_inverse();
  697. frame_params.collider_count = 1;
  698. frame_params.colliders[0].transform[0] = xform.columns[0][0];
  699. frame_params.colliders[0].transform[1] = xform.columns[0][1];
  700. frame_params.colliders[0].transform[2] = 0;
  701. frame_params.colliders[0].transform[3] = xform.columns[2][0];
  702. frame_params.colliders[0].transform[4] = xform.columns[1][0];
  703. frame_params.colliders[0].transform[5] = xform.columns[1][1];
  704. frame_params.colliders[0].transform[6] = 0;
  705. frame_params.colliders[0].transform[7] = xform.columns[2][1];
  706. frame_params.colliders[0].transform[8] = revert.columns[0][0];
  707. frame_params.colliders[0].transform[9] = revert.columns[0][1];
  708. frame_params.colliders[0].transform[10] = 0;
  709. frame_params.colliders[0].transform[11] = revert.columns[2][0];
  710. frame_params.colliders[0].transform[12] = revert.columns[1][0];
  711. frame_params.colliders[0].transform[13] = revert.columns[1][1];
  712. frame_params.colliders[0].transform[14] = 0;
  713. frame_params.colliders[0].transform[15] = revert.columns[2][1];
  714. frame_params.colliders[0].extents[0] = p_particles->sdf_collision_to_screen.size.x;
  715. frame_params.colliders[0].extents[1] = p_particles->sdf_collision_to_screen.size.y;
  716. frame_params.colliders[0].extents[2] = p_particles->sdf_collision_to_screen.position.x;
  717. frame_params.colliders[0].scale = p_particles->sdf_collision_to_screen.position.y;
  718. frame_params.colliders[0].texture_index = 0;
  719. frame_params.colliders[0].type = ParticlesFrameParams::COLLISION_TYPE_2D_SDF;
  720. collision_heightmap_texture = p_particles->sdf_collision_texture;
  721. //replace in all other history frames where used because parameters are no longer valid if screen moves
  722. for (ParticlesFrameParams &params : p_particles->frame_history) {
  723. if (params.collider_count > 0 && params.colliders[0].type == ParticlesFrameParams::COLLISION_TYPE_2D_SDF) {
  724. params.colliders[0] = frame_params.colliders[0];
  725. }
  726. }
  727. }
  728. uint32_t collision_3d_textures_used = 0;
  729. for (const RID &E : p_particles->collisions) {
  730. ParticlesCollisionInstance *pci = particles_collision_instance_owner.get_or_null(E);
  731. if (!pci || !pci->active) {
  732. continue;
  733. }
  734. ParticlesCollision *pc = particles_collision_owner.get_or_null(pci->collision);
  735. ERR_CONTINUE(!pc);
  736. Transform3D to_collider = pci->transform;
  737. if (p_particles->use_local_coords) {
  738. to_collider = to_particles * to_collider;
  739. }
  740. Vector3 scale = to_collider.basis.get_scale();
  741. to_collider.basis.orthonormalize();
  742. if (pc->type <= RS::PARTICLES_COLLISION_TYPE_VECTOR_FIELD_ATTRACT) {
  743. //attractor
  744. if (frame_params.attractor_count >= ParticlesFrameParams::MAX_ATTRACTORS) {
  745. continue;
  746. }
  747. ParticlesFrameParams::Attractor &attr = frame_params.attractors[frame_params.attractor_count];
  748. RendererRD::MaterialStorage::store_transform(to_collider, attr.transform);
  749. attr.strength = pc->attractor_strength;
  750. attr.attenuation = pc->attractor_attenuation;
  751. attr.directionality = pc->attractor_directionality;
  752. switch (pc->type) {
  753. case RS::PARTICLES_COLLISION_TYPE_SPHERE_ATTRACT: {
  754. attr.type = ParticlesFrameParams::ATTRACTOR_TYPE_SPHERE;
  755. float radius = pc->radius;
  756. radius *= (scale.x + scale.y + scale.z) / 3.0;
  757. attr.extents[0] = radius;
  758. attr.extents[1] = radius;
  759. attr.extents[2] = radius;
  760. } break;
  761. case RS::PARTICLES_COLLISION_TYPE_BOX_ATTRACT: {
  762. attr.type = ParticlesFrameParams::ATTRACTOR_TYPE_BOX;
  763. Vector3 extents = pc->extents * scale;
  764. attr.extents[0] = extents.x;
  765. attr.extents[1] = extents.y;
  766. attr.extents[2] = extents.z;
  767. } break;
  768. case RS::PARTICLES_COLLISION_TYPE_VECTOR_FIELD_ATTRACT: {
  769. if (collision_3d_textures_used >= ParticlesFrameParams::MAX_3D_TEXTURES) {
  770. continue;
  771. }
  772. attr.type = ParticlesFrameParams::ATTRACTOR_TYPE_VECTOR_FIELD;
  773. Vector3 extents = pc->extents * scale;
  774. attr.extents[0] = extents.x;
  775. attr.extents[1] = extents.y;
  776. attr.extents[2] = extents.z;
  777. attr.texture_index = collision_3d_textures_used;
  778. collision_3d_textures[collision_3d_textures_used] = pc->field_texture;
  779. collision_3d_textures_used++;
  780. } break;
  781. default: {
  782. }
  783. }
  784. frame_params.attractor_count++;
  785. } else {
  786. //collider
  787. if (frame_params.collider_count >= ParticlesFrameParams::MAX_COLLIDERS) {
  788. continue;
  789. }
  790. ParticlesFrameParams::Collider &col = frame_params.colliders[frame_params.collider_count];
  791. RendererRD::MaterialStorage::store_transform(to_collider, col.transform);
  792. switch (pc->type) {
  793. case RS::PARTICLES_COLLISION_TYPE_SPHERE_COLLIDE: {
  794. col.type = ParticlesFrameParams::COLLISION_TYPE_SPHERE;
  795. float radius = pc->radius;
  796. radius *= (scale.x + scale.y + scale.z) / 3.0;
  797. col.extents[0] = radius;
  798. col.extents[1] = radius;
  799. col.extents[2] = radius;
  800. } break;
  801. case RS::PARTICLES_COLLISION_TYPE_BOX_COLLIDE: {
  802. col.type = ParticlesFrameParams::COLLISION_TYPE_BOX;
  803. Vector3 extents = pc->extents * scale;
  804. col.extents[0] = extents.x;
  805. col.extents[1] = extents.y;
  806. col.extents[2] = extents.z;
  807. } break;
  808. case RS::PARTICLES_COLLISION_TYPE_SDF_COLLIDE: {
  809. if (collision_3d_textures_used >= ParticlesFrameParams::MAX_3D_TEXTURES) {
  810. continue;
  811. }
  812. col.type = ParticlesFrameParams::COLLISION_TYPE_SDF;
  813. Vector3 extents = pc->extents * scale;
  814. col.extents[0] = extents.x;
  815. col.extents[1] = extents.y;
  816. col.extents[2] = extents.z;
  817. col.texture_index = collision_3d_textures_used;
  818. col.scale = (scale.x + scale.y + scale.z) * 0.333333333333; //non uniform scale non supported
  819. collision_3d_textures[collision_3d_textures_used] = pc->field_texture;
  820. collision_3d_textures_used++;
  821. } break;
  822. case RS::PARTICLES_COLLISION_TYPE_HEIGHTFIELD_COLLIDE: {
  823. if (collision_heightmap_texture != RID()) { //already taken
  824. continue;
  825. }
  826. col.type = ParticlesFrameParams::COLLISION_TYPE_HEIGHT_FIELD;
  827. Vector3 extents = pc->extents * scale;
  828. col.extents[0] = extents.x;
  829. col.extents[1] = extents.y;
  830. col.extents[2] = extents.z;
  831. collision_heightmap_texture = pc->heightfield_texture;
  832. } break;
  833. default: {
  834. }
  835. }
  836. frame_params.collider_count++;
  837. }
  838. }
  839. bool different = false;
  840. if (collision_3d_textures_used == p_particles->collision_3d_textures_used) {
  841. for (int i = 0; i < ParticlesFrameParams::MAX_3D_TEXTURES; i++) {
  842. if (p_particles->collision_3d_textures[i] != collision_3d_textures[i]) {
  843. different = true;
  844. break;
  845. }
  846. }
  847. }
  848. if (collision_heightmap_texture != p_particles->collision_heightmap_texture) {
  849. different = true;
  850. }
  851. bool uniform_set_valid = RD::get_singleton()->uniform_set_is_valid(p_particles->collision_textures_uniform_set);
  852. if (different || !uniform_set_valid) {
  853. if (uniform_set_valid) {
  854. RD::get_singleton()->free(p_particles->collision_textures_uniform_set);
  855. }
  856. Vector<RD::Uniform> uniforms;
  857. {
  858. RD::Uniform u;
  859. u.uniform_type = RD::UNIFORM_TYPE_TEXTURE;
  860. u.binding = 0;
  861. for (uint32_t i = 0; i < ParticlesFrameParams::MAX_3D_TEXTURES; i++) {
  862. RID rd_tex;
  863. if (i < collision_3d_textures_used) {
  864. if (TextureStorage::get_singleton()->texture_get_type(collision_3d_textures[i]) == TextureStorage::TYPE_3D) {
  865. rd_tex = TextureStorage::get_singleton()->texture_get_rd_texture(collision_3d_textures[i]);
  866. }
  867. }
  868. if (rd_tex == RID()) {
  869. rd_tex = texture_storage->texture_rd_get_default(TextureStorage::DEFAULT_RD_TEXTURE_3D_WHITE);
  870. }
  871. u.append_id(rd_tex);
  872. }
  873. uniforms.push_back(u);
  874. }
  875. {
  876. RD::Uniform u;
  877. u.uniform_type = RD::UNIFORM_TYPE_TEXTURE;
  878. u.binding = 1;
  879. if (collision_heightmap_texture.is_valid()) {
  880. u.append_id(collision_heightmap_texture);
  881. } else {
  882. u.append_id(texture_storage->texture_rd_get_default(TextureStorage::DEFAULT_RD_TEXTURE_BLACK));
  883. }
  884. uniforms.push_back(u);
  885. }
  886. p_particles->collision_textures_uniform_set = RD::get_singleton()->uniform_set_create(uniforms, particles_shader.default_shader_rd, 2);
  887. p_particles->collision_heightmap_texture = collision_heightmap_texture;
  888. }
  889. }
  890. ParticlesShader::PushConstant push_constant;
  891. int process_amount = p_particles->amount;
  892. if (p_particles->trails_enabled && p_particles->trail_bind_poses.size() > 1) {
  893. process_amount *= p_particles->trail_bind_poses.size();
  894. }
  895. push_constant.clear = p_particles->clear;
  896. push_constant.total_particles = p_particles->amount;
  897. push_constant.lifetime = p_particles->lifetime;
  898. push_constant.trail_size = p_particles->trail_params.size();
  899. push_constant.use_fractional_delta = p_particles->fractional_delta;
  900. push_constant.sub_emitter_mode = !p_particles->emitting && p_particles->emission_buffer && (p_particles->emission_buffer->particle_count > 0 || p_particles->force_sub_emit);
  901. push_constant.trail_pass = false;
  902. p_particles->force_sub_emit = false; //reset
  903. Particles *sub_emitter = particles_owner.get_or_null(p_particles->sub_emitter);
  904. if (sub_emitter && sub_emitter->emission_storage_buffer.is_valid()) {
  905. // print_line("updating subemitter buffer");
  906. int32_t zero[4] = { 0, sub_emitter->amount, 0, 0 };
  907. RD::get_singleton()->buffer_update(sub_emitter->emission_storage_buffer, 0, sizeof(uint32_t) * 4, zero);
  908. push_constant.can_emit = true;
  909. if (sub_emitter->emitting) {
  910. sub_emitter->emitting = false;
  911. sub_emitter->clear = true; //will need to clear if it was emitting, sorry
  912. }
  913. //make sure the sub emitter processes particles too
  914. sub_emitter->inactive = false;
  915. sub_emitter->inactive_time = 0;
  916. sub_emitter->force_sub_emit = true;
  917. } else {
  918. push_constant.can_emit = false;
  919. }
  920. if (p_particles->emission_buffer && p_particles->emission_buffer->particle_count) {
  921. RD::get_singleton()->buffer_update(p_particles->emission_storage_buffer, 0, sizeof(uint32_t) * 4 + sizeof(ParticleEmissionBuffer::Data) * p_particles->emission_buffer->particle_count, p_particles->emission_buffer);
  922. p_particles->emission_buffer->particle_count = 0;
  923. }
  924. p_particles->clear = false;
  925. if (p_particles->trail_params.size() > 1) {
  926. //fill the trail params
  927. for (uint32_t i = 0; i < p_particles->trail_params.size(); i++) {
  928. uint32_t src_idx = i * p_particles->frame_history.size() / p_particles->trail_params.size();
  929. p_particles->trail_params[i] = p_particles->frame_history[src_idx];
  930. }
  931. } else {
  932. p_particles->trail_params[0] = p_particles->frame_history[0];
  933. }
  934. RD::get_singleton()->buffer_update(p_particles->frame_params_buffer, 0, sizeof(ParticlesFrameParams) * p_particles->trail_params.size(), p_particles->trail_params.ptr());
  935. ParticleProcessMaterialData *m = static_cast<ParticleProcessMaterialData *>(material_storage->material_get_data(p_particles->process_material, MaterialStorage::SHADER_TYPE_PARTICLES));
  936. if (!m) {
  937. m = static_cast<ParticleProcessMaterialData *>(material_storage->material_get_data(particles_shader.default_material, MaterialStorage::SHADER_TYPE_PARTICLES));
  938. }
  939. ERR_FAIL_NULL(m);
  940. p_particles->has_collision_cache = m->shader_data->uses_collision;
  941. //todo should maybe compute all particle systems together?
  942. RD::ComputeListID compute_list = RD::get_singleton()->compute_list_begin();
  943. RD::get_singleton()->compute_list_bind_compute_pipeline(compute_list, m->shader_data->pipeline);
  944. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, particles_shader.base_uniform_set, BASE_UNIFORM_SET);
  945. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, p_particles->particles_material_uniform_set, MATERIAL_UNIFORM_SET);
  946. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, p_particles->collision_textures_uniform_set, COLLISION_TEXTURTES_UNIFORM_SET);
  947. if (m->uniform_set.is_valid() && RD::get_singleton()->uniform_set_is_valid(m->uniform_set)) {
  948. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, m->uniform_set, 3);
  949. m->set_as_used();
  950. }
  951. RD::get_singleton()->compute_list_set_push_constant(compute_list, &push_constant, sizeof(ParticlesShader::PushConstant));
  952. if (p_particles->trails_enabled && p_particles->trail_bind_poses.size() > 1) {
  953. //trails requires two passes in order to catch particle starts
  954. RD::get_singleton()->compute_list_dispatch_threads(compute_list, process_amount / p_particles->trail_bind_poses.size(), 1, 1);
  955. RD::get_singleton()->compute_list_add_barrier(compute_list);
  956. push_constant.trail_pass = true;
  957. RD::get_singleton()->compute_list_set_push_constant(compute_list, &push_constant, sizeof(ParticlesShader::PushConstant));
  958. RD::get_singleton()->compute_list_dispatch_threads(compute_list, process_amount - p_particles->amount, 1, 1);
  959. } else {
  960. RD::get_singleton()->compute_list_dispatch_threads(compute_list, process_amount, 1, 1);
  961. }
  962. RD::get_singleton()->compute_list_end();
  963. }
  964. void ParticlesStorage::particles_set_view_axis(RID p_particles, const Vector3 &p_axis, const Vector3 &p_up_axis) {
  965. Particles *particles = particles_owner.get_or_null(p_particles);
  966. ERR_FAIL_NULL(particles);
  967. if (particles->draw_order != RS::PARTICLES_DRAW_ORDER_VIEW_DEPTH && particles->transform_align != RS::PARTICLES_TRANSFORM_ALIGN_Z_BILLBOARD && particles->transform_align != RS::PARTICLES_TRANSFORM_ALIGN_Z_BILLBOARD_Y_TO_VELOCITY) {
  968. return;
  969. }
  970. if (particles->particle_buffer.is_null() || particles->trail_bind_pose_uniform_set.is_null()) {
  971. return; //particles have not processed yet
  972. }
  973. bool do_sort = particles->draw_order == RS::PARTICLES_DRAW_ORDER_VIEW_DEPTH;
  974. //copy to sort buffer
  975. if (do_sort && particles->particles_sort_buffer == RID()) {
  976. uint32_t size = particles->amount;
  977. if (size & 1) {
  978. size++; //make multiple of 16
  979. }
  980. size *= sizeof(float) * 2;
  981. particles->particles_sort_buffer = RD::get_singleton()->storage_buffer_create(size);
  982. {
  983. Vector<RD::Uniform> uniforms;
  984. {
  985. RD::Uniform u;
  986. u.uniform_type = RD::UNIFORM_TYPE_STORAGE_BUFFER;
  987. u.binding = 0;
  988. u.append_id(particles->particles_sort_buffer);
  989. uniforms.push_back(u);
  990. }
  991. particles->particles_sort_uniform_set = RD::get_singleton()->uniform_set_create(uniforms, particles_shader.copy_shader.version_get_shader(particles_shader.copy_shader_version, ParticlesShader::COPY_MODE_FILL_SORT_BUFFER), 1);
  992. }
  993. }
  994. ParticlesShader::CopyPushConstant copy_push_constant;
  995. if (particles->trails_enabled && particles->trail_bind_poses.size() > 1) {
  996. int fixed_fps = 60.0;
  997. if (particles->fixed_fps > 0) {
  998. fixed_fps = particles->fixed_fps;
  999. }
  1000. copy_push_constant.trail_size = particles->trail_bind_poses.size();
  1001. copy_push_constant.trail_total = particles->frame_history.size();
  1002. copy_push_constant.frame_delta = 1.0 / fixed_fps;
  1003. } else {
  1004. copy_push_constant.trail_size = 1;
  1005. copy_push_constant.trail_total = 1;
  1006. copy_push_constant.frame_delta = 0.0;
  1007. }
  1008. copy_push_constant.order_by_lifetime = (particles->draw_order == RS::PARTICLES_DRAW_ORDER_LIFETIME || particles->draw_order == RS::PARTICLES_DRAW_ORDER_REVERSE_LIFETIME);
  1009. copy_push_constant.lifetime_split = (MIN(int(particles->amount * particles->phase), particles->amount - 1) + 1) % particles->amount;
  1010. copy_push_constant.lifetime_reverse = particles->draw_order == RS::PARTICLES_DRAW_ORDER_REVERSE_LIFETIME;
  1011. copy_push_constant.motion_vectors_current_offset = particles->instance_motion_vectors_current_offset;
  1012. copy_push_constant.frame_remainder = particles->interpolate ? particles->frame_remainder : 0.0;
  1013. copy_push_constant.total_particles = particles->amount;
  1014. copy_push_constant.copy_mode_2d = false;
  1015. Vector3 axis = -p_axis; // cameras look to z negative
  1016. if (particles->use_local_coords) {
  1017. axis = particles->emission_transform.basis.xform_inv(axis).normalized();
  1018. }
  1019. copy_push_constant.sort_direction[0] = axis.x;
  1020. copy_push_constant.sort_direction[1] = axis.y;
  1021. copy_push_constant.sort_direction[2] = axis.z;
  1022. copy_push_constant.align_up[0] = p_up_axis.x;
  1023. copy_push_constant.align_up[1] = p_up_axis.y;
  1024. copy_push_constant.align_up[2] = p_up_axis.z;
  1025. copy_push_constant.align_mode = particles->transform_align;
  1026. if (do_sort) {
  1027. RD::ComputeListID compute_list = RD::get_singleton()->compute_list_begin();
  1028. RD::get_singleton()->compute_list_bind_compute_pipeline(compute_list, particles_shader.copy_pipelines[ParticlesShader::COPY_MODE_FILL_SORT_BUFFER + particles->userdata_count * ParticlesShader::COPY_MODE_MAX]);
  1029. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, particles->particles_copy_uniform_set, 0);
  1030. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, particles->particles_sort_uniform_set, 1);
  1031. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, particles->trail_bind_pose_uniform_set, 2);
  1032. RD::get_singleton()->compute_list_set_push_constant(compute_list, &copy_push_constant, sizeof(ParticlesShader::CopyPushConstant));
  1033. RD::get_singleton()->compute_list_dispatch_threads(compute_list, particles->amount, 1, 1);
  1034. RD::get_singleton()->compute_list_end();
  1035. sort_effects->sort_buffer(particles->particles_sort_uniform_set, particles->amount);
  1036. }
  1037. if (particles->trails_enabled && particles->trail_bind_poses.size() > 1) {
  1038. copy_push_constant.total_particles *= particles->trail_bind_poses.size();
  1039. }
  1040. RD::ComputeListID compute_list = RD::get_singleton()->compute_list_begin();
  1041. uint32_t copy_pipeline = do_sort ? ParticlesShader::COPY_MODE_FILL_INSTANCES_WITH_SORT_BUFFER : ParticlesShader::COPY_MODE_FILL_INSTANCES;
  1042. copy_pipeline += particles->userdata_count * ParticlesShader::COPY_MODE_MAX;
  1043. copy_push_constant.copy_mode_2d = particles->mode == RS::PARTICLES_MODE_2D ? 1 : 0;
  1044. RD::get_singleton()->compute_list_bind_compute_pipeline(compute_list, particles_shader.copy_pipelines[copy_pipeline]);
  1045. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, particles->particles_copy_uniform_set, 0);
  1046. if (do_sort) {
  1047. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, particles->particles_sort_uniform_set, 1);
  1048. }
  1049. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, particles->trail_bind_pose_uniform_set, 2);
  1050. RD::get_singleton()->compute_list_set_push_constant(compute_list, &copy_push_constant, sizeof(ParticlesShader::CopyPushConstant));
  1051. RD::get_singleton()->compute_list_dispatch_threads(compute_list, copy_push_constant.total_particles, 1, 1);
  1052. RD::get_singleton()->compute_list_end();
  1053. }
  1054. void ParticlesStorage::_particles_update_buffers(Particles *particles) {
  1055. uint32_t userdata_count = 0;
  1056. MaterialStorage::ShaderData *shader_data = MaterialStorage::get_singleton()->material_get_shader_data(particles->process_material);
  1057. if (shader_data) {
  1058. const ParticlesShaderData *particle_shader_data = static_cast<const ParticlesShaderData *>(shader_data);
  1059. userdata_count = particle_shader_data->userdata_count;
  1060. }
  1061. bool uses_motion_vectors = RSG::viewport->get_num_viewports_with_motion_vectors() > 0;
  1062. bool index_draw_order = particles->draw_order == RS::ParticlesDrawOrder::PARTICLES_DRAW_ORDER_INDEX;
  1063. bool enable_motion_vectors = uses_motion_vectors && index_draw_order && !particles->instance_motion_vectors_enabled;
  1064. bool only_instances_changed = false;
  1065. if (userdata_count != particles->userdata_count) {
  1066. // Mismatch userdata, re-create all buffers.
  1067. _particles_free_data(particles);
  1068. } else if (enable_motion_vectors) {
  1069. // Only motion vectors are required, release the transforms buffer and uniform set.
  1070. if (particles->particle_instance_buffer.is_valid()) {
  1071. RD::get_singleton()->free(particles->particle_instance_buffer);
  1072. particles->particle_instance_buffer = RID();
  1073. }
  1074. particles->particles_transforms_buffer_uniform_set = RID();
  1075. only_instances_changed = true;
  1076. } else if (!particles->particle_buffer.is_null()) {
  1077. // No operation is required because a buffer already exists, return early.
  1078. return;
  1079. }
  1080. if (particles->amount > 0) {
  1081. int total_amount = particles->amount;
  1082. if (particles->trails_enabled && particles->trail_bind_poses.size() > 1) {
  1083. total_amount *= particles->trail_bind_poses.size();
  1084. }
  1085. uint32_t xform_size = particles->mode == RS::PARTICLES_MODE_2D ? 2 : 3;
  1086. if (particles->particle_buffer.is_null()) {
  1087. particles->particle_buffer = RD::get_singleton()->storage_buffer_create((sizeof(ParticleData) + userdata_count * sizeof(float) * 4) * total_amount);
  1088. particles->userdata_count = userdata_count;
  1089. }
  1090. PackedByteArray data;
  1091. uint32_t particle_instance_buffer_size = total_amount * (xform_size + 1 + 1) * sizeof(float) * 4;
  1092. if (uses_motion_vectors) {
  1093. particle_instance_buffer_size *= 2;
  1094. particles->instance_motion_vectors_enabled = true;
  1095. }
  1096. data.resize_zeroed(particle_instance_buffer_size);
  1097. particles->particle_instance_buffer = RD::get_singleton()->storage_buffer_create(particle_instance_buffer_size, data);
  1098. {
  1099. Vector<RD::Uniform> uniforms;
  1100. {
  1101. RD::Uniform u;
  1102. u.uniform_type = RD::UNIFORM_TYPE_STORAGE_BUFFER;
  1103. u.binding = 1;
  1104. u.append_id(particles->particle_buffer);
  1105. uniforms.push_back(u);
  1106. }
  1107. {
  1108. RD::Uniform u;
  1109. u.uniform_type = RD::UNIFORM_TYPE_STORAGE_BUFFER;
  1110. u.binding = 2;
  1111. u.append_id(particles->particle_instance_buffer);
  1112. uniforms.push_back(u);
  1113. }
  1114. particles->particles_copy_uniform_set = RD::get_singleton()->uniform_set_create(uniforms, particles_shader.copy_shader.version_get_shader(particles_shader.copy_shader_version, 0), 0);
  1115. }
  1116. particles->instance_motion_vectors_current_offset = 0;
  1117. particles->instance_motion_vectors_previous_offset = 0;
  1118. particles->instance_motion_vectors_last_change = -1;
  1119. if (only_instances_changed) {
  1120. // Notify the renderer the instances uniform must be retrieved again, as it's the only element that has been changed because motion vectors were enabled.
  1121. particles->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_PARTICLES_INSTANCES);
  1122. }
  1123. }
  1124. }
  1125. void ParticlesStorage::update_particles() {
  1126. uint32_t frame = RSG::rasterizer->get_frame_number();
  1127. bool uses_motion_vectors = RSG::viewport->get_num_viewports_with_motion_vectors() > 0;
  1128. while (particle_update_list.first()) {
  1129. //use transform feedback to process particles
  1130. Particles *particles = particle_update_list.first()->self();
  1131. particles->update_list.remove_from_list();
  1132. particles->dirty = false;
  1133. _particles_update_buffers(particles);
  1134. if (particles->restart_request) {
  1135. particles->prev_ticks = 0;
  1136. particles->phase = 0;
  1137. particles->prev_phase = 0;
  1138. particles->clear = true;
  1139. particles->restart_request = false;
  1140. }
  1141. if (particles->inactive && !particles->emitting) {
  1142. //go next
  1143. continue;
  1144. }
  1145. if (particles->emitting) {
  1146. if (particles->inactive) {
  1147. //restart system from scratch
  1148. particles->prev_ticks = 0;
  1149. particles->phase = 0;
  1150. particles->prev_phase = 0;
  1151. particles->clear = true;
  1152. }
  1153. particles->inactive = false;
  1154. particles->inactive_time = 0;
  1155. } else {
  1156. particles->inactive_time += particles->speed_scale * RendererCompositorRD::get_singleton()->get_frame_delta_time();
  1157. if (particles->inactive_time > particles->lifetime * 1.2) {
  1158. particles->inactive = true;
  1159. continue;
  1160. }
  1161. }
  1162. // TODO: Should use display refresh rate for all this.
  1163. float screen_hz = 60;
  1164. int fixed_fps = 0;
  1165. if (particles->fixed_fps > 0) {
  1166. fixed_fps = particles->fixed_fps;
  1167. } else if (particles->trails_enabled && particles->trail_bind_poses.size() > 1) {
  1168. fixed_fps = screen_hz;
  1169. }
  1170. {
  1171. //update trails
  1172. int history_size = 1;
  1173. int trail_steps = 1;
  1174. if (particles->trails_enabled && particles->trail_bind_poses.size() > 1) {
  1175. history_size = MAX(1, int(particles->trail_lifetime * fixed_fps));
  1176. trail_steps = particles->trail_bind_poses.size();
  1177. }
  1178. if (uint32_t(history_size) != particles->frame_history.size()) {
  1179. particles->frame_history.resize(history_size);
  1180. memset(particles->frame_history.ptr(), 0, sizeof(ParticlesFrameParams) * history_size);
  1181. }
  1182. if (uint32_t(trail_steps) != particles->trail_params.size() || particles->frame_params_buffer.is_null()) {
  1183. particles->trail_params.resize(trail_steps);
  1184. if (particles->frame_params_buffer.is_valid()) {
  1185. RD::get_singleton()->free(particles->frame_params_buffer);
  1186. }
  1187. particles->frame_params_buffer = RD::get_singleton()->storage_buffer_create(sizeof(ParticlesFrameParams) * trail_steps);
  1188. }
  1189. if (particles->trail_bind_poses.size() > 1 && particles->trail_bind_pose_buffer.is_null()) {
  1190. particles->trail_bind_pose_buffer = RD::get_singleton()->storage_buffer_create(sizeof(float) * 16 * particles->trail_bind_poses.size());
  1191. particles->trail_bind_poses_dirty = true;
  1192. }
  1193. if (particles->trail_bind_pose_uniform_set.is_null()) {
  1194. Vector<RD::Uniform> uniforms;
  1195. {
  1196. RD::Uniform u;
  1197. u.uniform_type = RD::UNIFORM_TYPE_STORAGE_BUFFER;
  1198. u.binding = 0;
  1199. if (particles->trail_bind_pose_buffer.is_valid()) {
  1200. u.append_id(particles->trail_bind_pose_buffer);
  1201. } else {
  1202. _particles_ensure_unused_buffer(particles);
  1203. u.append_id(particles->unused_storage_buffer);
  1204. }
  1205. uniforms.push_back(u);
  1206. }
  1207. particles->trail_bind_pose_uniform_set = RD::get_singleton()->uniform_set_create(uniforms, particles_shader.copy_shader.version_get_shader(particles_shader.copy_shader_version, 0), 2);
  1208. }
  1209. if (particles->trail_bind_pose_buffer.is_valid() && particles->trail_bind_poses_dirty) {
  1210. if (particles_shader.pose_update_buffer.size() < uint32_t(particles->trail_bind_poses.size()) * 16) {
  1211. particles_shader.pose_update_buffer.resize(particles->trail_bind_poses.size() * 16);
  1212. }
  1213. for (int i = 0; i < particles->trail_bind_poses.size(); i++) {
  1214. RendererRD::MaterialStorage::store_transform(particles->trail_bind_poses[i], &particles_shader.pose_update_buffer[i * 16]);
  1215. }
  1216. RD::get_singleton()->buffer_update(particles->trail_bind_pose_buffer, 0, particles->trail_bind_poses.size() * 16 * sizeof(float), particles_shader.pose_update_buffer.ptr());
  1217. }
  1218. }
  1219. bool zero_time_scale = Engine::get_singleton()->get_time_scale() <= 0.0;
  1220. if (particles->clear && particles->pre_process_time > 0.0) {
  1221. double frame_time;
  1222. if (fixed_fps > 0) {
  1223. frame_time = 1.0 / fixed_fps;
  1224. } else {
  1225. frame_time = 1.0 / 30.0;
  1226. }
  1227. double todo = particles->pre_process_time;
  1228. while (todo >= 0) {
  1229. _particles_process(particles, frame_time);
  1230. todo -= frame_time;
  1231. }
  1232. }
  1233. if (fixed_fps > 0) {
  1234. double frame_time;
  1235. double decr;
  1236. if (zero_time_scale) {
  1237. frame_time = 0.0;
  1238. decr = 1.0 / fixed_fps;
  1239. } else {
  1240. frame_time = 1.0 / fixed_fps;
  1241. decr = frame_time;
  1242. }
  1243. double delta = RendererCompositorRD::get_singleton()->get_frame_delta_time();
  1244. if (delta > 0.1) { //avoid recursive stalls if fps goes below 10
  1245. delta = 0.1;
  1246. } else if (delta <= 0.0) { //unlikely but..
  1247. delta = 0.001;
  1248. }
  1249. double todo = particles->frame_remainder + delta;
  1250. while (todo >= frame_time || particles->clear) {
  1251. _particles_process(particles, frame_time);
  1252. todo -= decr;
  1253. }
  1254. particles->frame_remainder = todo;
  1255. } else {
  1256. if (zero_time_scale) {
  1257. _particles_process(particles, 0.0);
  1258. } else {
  1259. _particles_process(particles, RendererCompositorRD::get_singleton()->get_frame_delta_time());
  1260. }
  1261. }
  1262. // Ensure that memory is initialized (the code above should ensure that _particles_process is always called at least once upon clearing).
  1263. DEV_ASSERT(!particles->clear);
  1264. int total_amount = particles->amount;
  1265. if (particles->trails_enabled && particles->trail_bind_poses.size() > 1) {
  1266. total_amount *= particles->trail_bind_poses.size();
  1267. }
  1268. // Swap offsets for motion vectors. Motion vectors can only be used when the draw order keeps the indices consistent across frames.
  1269. bool index_draw_order = particles->draw_order == RS::ParticlesDrawOrder::PARTICLES_DRAW_ORDER_INDEX;
  1270. particles->instance_motion_vectors_previous_offset = particles->instance_motion_vectors_current_offset;
  1271. if (uses_motion_vectors && index_draw_order && particles->instance_motion_vectors_enabled && (frame - particles->instance_motion_vectors_last_change) == 1) {
  1272. particles->instance_motion_vectors_current_offset = total_amount - particles->instance_motion_vectors_current_offset;
  1273. }
  1274. particles->instance_motion_vectors_last_change = frame;
  1275. // Copy particles to instance buffer.
  1276. if (particles->draw_order != RS::PARTICLES_DRAW_ORDER_VIEW_DEPTH && particles->transform_align != RS::PARTICLES_TRANSFORM_ALIGN_Z_BILLBOARD && particles->transform_align != RS::PARTICLES_TRANSFORM_ALIGN_Z_BILLBOARD_Y_TO_VELOCITY) {
  1277. //does not need view dependent operation, do copy here
  1278. ParticlesShader::CopyPushConstant copy_push_constant;
  1279. // Affect 2D only.
  1280. if (particles->use_local_coords) {
  1281. // In local mode, particle positions are calculated locally (relative to the node position)
  1282. // and they're also drawn locally.
  1283. // It works as expected, so we just pass an identity transform.
  1284. RendererRD::MaterialStorage::store_transform(Transform3D(), copy_push_constant.inv_emission_transform);
  1285. } else {
  1286. // In global mode, particle positions are calculated globally (relative to the canvas origin)
  1287. // but they're drawn locally.
  1288. // So, we need to pass the inverse of the emission transform to bring the
  1289. // particles to local coordinates before drawing.
  1290. Transform3D inv = particles->emission_transform.affine_inverse();
  1291. RendererRD::MaterialStorage::store_transform(inv, copy_push_constant.inv_emission_transform);
  1292. }
  1293. copy_push_constant.total_particles = total_amount;
  1294. copy_push_constant.frame_remainder = particles->interpolate ? particles->frame_remainder : 0.0;
  1295. copy_push_constant.align_mode = particles->transform_align;
  1296. copy_push_constant.align_up[0] = 0;
  1297. copy_push_constant.align_up[1] = 0;
  1298. copy_push_constant.align_up[2] = 0;
  1299. if (particles->trails_enabled && particles->trail_bind_poses.size() > 1) {
  1300. copy_push_constant.trail_size = particles->trail_bind_poses.size();
  1301. copy_push_constant.trail_total = particles->frame_history.size();
  1302. copy_push_constant.frame_delta = 1.0 / fixed_fps;
  1303. } else {
  1304. copy_push_constant.trail_size = 1;
  1305. copy_push_constant.trail_total = 1;
  1306. copy_push_constant.frame_delta = 0.0;
  1307. }
  1308. copy_push_constant.order_by_lifetime = (particles->draw_order == RS::PARTICLES_DRAW_ORDER_LIFETIME || particles->draw_order == RS::PARTICLES_DRAW_ORDER_REVERSE_LIFETIME);
  1309. copy_push_constant.lifetime_split = (MIN(int(particles->amount * particles->phase), particles->amount - 1) + 1) % particles->amount;
  1310. copy_push_constant.lifetime_reverse = particles->draw_order == RS::PARTICLES_DRAW_ORDER_REVERSE_LIFETIME;
  1311. copy_push_constant.motion_vectors_current_offset = particles->instance_motion_vectors_current_offset;
  1312. RD::ComputeListID compute_list = RD::get_singleton()->compute_list_begin();
  1313. copy_push_constant.copy_mode_2d = particles->mode == RS::PARTICLES_MODE_2D ? 1 : 0;
  1314. RD::get_singleton()->compute_list_bind_compute_pipeline(compute_list, particles_shader.copy_pipelines[ParticlesShader::COPY_MODE_FILL_INSTANCES + particles->userdata_count * ParticlesShader::COPY_MODE_MAX]);
  1315. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, particles->particles_copy_uniform_set, 0);
  1316. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, particles->trail_bind_pose_uniform_set, 2);
  1317. RD::get_singleton()->compute_list_set_push_constant(compute_list, &copy_push_constant, sizeof(ParticlesShader::CopyPushConstant));
  1318. RD::get_singleton()->compute_list_dispatch_threads(compute_list, total_amount, 1, 1);
  1319. RD::get_singleton()->compute_list_end();
  1320. }
  1321. particles->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_AABB);
  1322. }
  1323. }
  1324. Dependency *ParticlesStorage::particles_get_dependency(RID p_particles) const {
  1325. Particles *particles = particles_owner.get_or_null(p_particles);
  1326. ERR_FAIL_NULL_V(particles, nullptr);
  1327. return &particles->dependency;
  1328. }
  1329. bool ParticlesStorage::particles_is_inactive(RID p_particles) const {
  1330. ERR_FAIL_COND_V_MSG(RSG::threaded, false, "This function should never be used with threaded rendering, as it stalls the renderer.");
  1331. const Particles *particles = particles_owner.get_or_null(p_particles);
  1332. ERR_FAIL_NULL_V(particles, false);
  1333. return !particles->emitting && particles->inactive;
  1334. }
  1335. /* Particles SHADER */
  1336. void ParticlesStorage::ParticlesShaderData::set_code(const String &p_code) {
  1337. ParticlesStorage *particles_storage = ParticlesStorage::get_singleton();
  1338. //compile
  1339. code = p_code;
  1340. valid = false;
  1341. ubo_size = 0;
  1342. uniforms.clear();
  1343. uses_collision = false;
  1344. if (code.is_empty()) {
  1345. return; //just invalid, but no error
  1346. }
  1347. ShaderCompiler::GeneratedCode gen_code;
  1348. ShaderCompiler::IdentifierActions actions;
  1349. actions.entry_point_stages["start"] = ShaderCompiler::STAGE_COMPUTE;
  1350. actions.entry_point_stages["process"] = ShaderCompiler::STAGE_COMPUTE;
  1351. /*
  1352. uses_time = false;
  1353. actions.render_mode_flags["use_half_res_pass"] = &uses_half_res;
  1354. actions.render_mode_flags["use_quarter_res_pass"] = &uses_quarter_res;
  1355. actions.usage_flag_pointers["TIME"] = &uses_time;
  1356. */
  1357. actions.usage_flag_pointers["COLLIDED"] = &uses_collision;
  1358. userdata_count = 0;
  1359. for (uint32_t i = 0; i < ParticlesShader::MAX_USERDATAS; i++) {
  1360. userdatas_used[i] = false;
  1361. actions.usage_flag_pointers["USERDATA" + itos(i + 1)] = &userdatas_used[i];
  1362. }
  1363. actions.uniforms = &uniforms;
  1364. Error err = particles_storage->particles_shader.compiler.compile(RS::SHADER_PARTICLES, code, &actions, path, gen_code);
  1365. ERR_FAIL_COND_MSG(err != OK, "Shader compilation failed.");
  1366. if (version.is_null()) {
  1367. version = particles_storage->particles_shader.shader.version_create();
  1368. }
  1369. for (uint32_t i = 0; i < ParticlesShader::MAX_USERDATAS; i++) {
  1370. if (userdatas_used[i]) {
  1371. userdata_count++;
  1372. }
  1373. }
  1374. particles_storage->particles_shader.shader.version_set_compute_code(version, gen_code.code, gen_code.uniforms, gen_code.stage_globals[ShaderCompiler::STAGE_COMPUTE], gen_code.defines);
  1375. ERR_FAIL_COND(!particles_storage->particles_shader.shader.version_is_valid(version));
  1376. ubo_size = gen_code.uniform_total_size;
  1377. ubo_offsets = gen_code.uniform_offsets;
  1378. texture_uniforms = gen_code.texture_uniforms;
  1379. //update pipelines
  1380. pipeline = RD::get_singleton()->compute_pipeline_create(particles_storage->particles_shader.shader.version_get_shader(version, 0));
  1381. valid = true;
  1382. }
  1383. bool ParticlesStorage::ParticlesShaderData::is_animated() const {
  1384. return false;
  1385. }
  1386. bool ParticlesStorage::ParticlesShaderData::casts_shadows() const {
  1387. return false;
  1388. }
  1389. RS::ShaderNativeSourceCode ParticlesStorage::ParticlesShaderData::get_native_source_code() const {
  1390. return ParticlesStorage::get_singleton()->particles_shader.shader.version_get_native_source_code(version);
  1391. }
  1392. ParticlesStorage::ParticlesShaderData::~ParticlesShaderData() {
  1393. //pipeline variants will clear themselves if shader is gone
  1394. if (version.is_valid()) {
  1395. ParticlesStorage::get_singleton()->particles_shader.shader.version_free(version);
  1396. }
  1397. }
  1398. MaterialStorage::ShaderData *ParticlesStorage::_create_particles_shader_func() {
  1399. ParticlesShaderData *shader_data = memnew(ParticlesShaderData);
  1400. return shader_data;
  1401. }
  1402. bool ParticlesStorage::ParticleProcessMaterialData::update_parameters(const HashMap<StringName, Variant> &p_parameters, bool p_uniform_dirty, bool p_textures_dirty) {
  1403. return update_parameters_uniform_set(p_parameters, p_uniform_dirty, p_textures_dirty, shader_data->uniforms, shader_data->ubo_offsets.ptr(), shader_data->texture_uniforms, shader_data->default_texture_params, shader_data->ubo_size, uniform_set, ParticlesStorage::get_singleton()->particles_shader.shader.version_get_shader(shader_data->version, 0), 3, true, false);
  1404. }
  1405. ParticlesStorage::ParticleProcessMaterialData::~ParticleProcessMaterialData() {
  1406. free_parameters_uniform_set(uniform_set);
  1407. }
  1408. MaterialStorage::MaterialData *ParticlesStorage::_create_particles_material_func(ParticlesShaderData *p_shader) {
  1409. ParticleProcessMaterialData *material_data = memnew(ParticleProcessMaterialData);
  1410. material_data->shader_data = p_shader;
  1411. //update will happen later anyway so do nothing.
  1412. return material_data;
  1413. }
  1414. ////////
  1415. /* PARTICLES COLLISION API */
  1416. RID ParticlesStorage::particles_collision_allocate() {
  1417. return particles_collision_owner.allocate_rid();
  1418. }
  1419. void ParticlesStorage::particles_collision_initialize(RID p_rid) {
  1420. particles_collision_owner.initialize_rid(p_rid, ParticlesCollision());
  1421. }
  1422. void ParticlesStorage::particles_collision_free(RID p_rid) {
  1423. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_rid);
  1424. if (particles_collision->heightfield_texture.is_valid()) {
  1425. RD::get_singleton()->free(particles_collision->heightfield_texture);
  1426. }
  1427. particles_collision->dependency.deleted_notify(p_rid);
  1428. particles_collision_owner.free(p_rid);
  1429. }
  1430. RID ParticlesStorage::particles_collision_get_heightfield_framebuffer(RID p_particles_collision) const {
  1431. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1432. ERR_FAIL_NULL_V(particles_collision, RID());
  1433. ERR_FAIL_COND_V(particles_collision->type != RS::PARTICLES_COLLISION_TYPE_HEIGHTFIELD_COLLIDE, RID());
  1434. if (particles_collision->heightfield_texture == RID()) {
  1435. //create
  1436. const int resolutions[RS::PARTICLES_COLLISION_HEIGHTFIELD_RESOLUTION_MAX] = { 256, 512, 1024, 2048, 4096, 8192 };
  1437. Size2i size;
  1438. if (particles_collision->extents.x > particles_collision->extents.z) {
  1439. size.x = resolutions[particles_collision->heightfield_resolution];
  1440. size.y = int32_t(particles_collision->extents.z / particles_collision->extents.x * size.x);
  1441. } else {
  1442. size.y = resolutions[particles_collision->heightfield_resolution];
  1443. size.x = int32_t(particles_collision->extents.x / particles_collision->extents.z * size.y);
  1444. }
  1445. RD::TextureFormat tf;
  1446. tf.format = RD::DATA_FORMAT_D32_SFLOAT;
  1447. tf.width = size.x;
  1448. tf.height = size.y;
  1449. tf.texture_type = RD::TEXTURE_TYPE_2D;
  1450. tf.usage_bits = RD::TEXTURE_USAGE_SAMPLING_BIT | RD::TEXTURE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT;
  1451. particles_collision->heightfield_texture = RD::get_singleton()->texture_create(tf, RD::TextureView());
  1452. Vector<RID> fb_tex;
  1453. fb_tex.push_back(particles_collision->heightfield_texture);
  1454. particles_collision->heightfield_fb = RD::get_singleton()->framebuffer_create(fb_tex);
  1455. particles_collision->heightfield_fb_size = size;
  1456. }
  1457. return particles_collision->heightfield_fb;
  1458. }
  1459. void ParticlesStorage::particles_collision_set_collision_type(RID p_particles_collision, RS::ParticlesCollisionType p_type) {
  1460. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1461. ERR_FAIL_NULL(particles_collision);
  1462. if (p_type == particles_collision->type) {
  1463. return;
  1464. }
  1465. if (particles_collision->heightfield_texture.is_valid()) {
  1466. RD::get_singleton()->free(particles_collision->heightfield_texture);
  1467. particles_collision->heightfield_texture = RID();
  1468. }
  1469. particles_collision->type = p_type;
  1470. particles_collision->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_AABB);
  1471. }
  1472. void ParticlesStorage::particles_collision_set_cull_mask(RID p_particles_collision, uint32_t p_cull_mask) {
  1473. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1474. ERR_FAIL_NULL(particles_collision);
  1475. particles_collision->cull_mask = p_cull_mask;
  1476. }
  1477. void ParticlesStorage::particles_collision_set_sphere_radius(RID p_particles_collision, real_t p_radius) {
  1478. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1479. ERR_FAIL_NULL(particles_collision);
  1480. particles_collision->radius = p_radius;
  1481. particles_collision->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_AABB);
  1482. }
  1483. void ParticlesStorage::particles_collision_set_box_extents(RID p_particles_collision, const Vector3 &p_extents) {
  1484. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1485. ERR_FAIL_NULL(particles_collision);
  1486. particles_collision->extents = p_extents;
  1487. particles_collision->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_AABB);
  1488. }
  1489. void ParticlesStorage::particles_collision_set_attractor_strength(RID p_particles_collision, real_t p_strength) {
  1490. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1491. ERR_FAIL_NULL(particles_collision);
  1492. particles_collision->attractor_strength = p_strength;
  1493. }
  1494. void ParticlesStorage::particles_collision_set_attractor_directionality(RID p_particles_collision, real_t p_directionality) {
  1495. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1496. ERR_FAIL_NULL(particles_collision);
  1497. particles_collision->attractor_directionality = p_directionality;
  1498. }
  1499. void ParticlesStorage::particles_collision_set_attractor_attenuation(RID p_particles_collision, real_t p_curve) {
  1500. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1501. ERR_FAIL_NULL(particles_collision);
  1502. particles_collision->attractor_attenuation = p_curve;
  1503. }
  1504. void ParticlesStorage::particles_collision_set_field_texture(RID p_particles_collision, RID p_texture) {
  1505. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1506. ERR_FAIL_NULL(particles_collision);
  1507. particles_collision->field_texture = p_texture;
  1508. }
  1509. void ParticlesStorage::particles_collision_height_field_update(RID p_particles_collision) {
  1510. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1511. ERR_FAIL_NULL(particles_collision);
  1512. particles_collision->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_AABB);
  1513. }
  1514. void ParticlesStorage::particles_collision_set_height_field_resolution(RID p_particles_collision, RS::ParticlesCollisionHeightfieldResolution p_resolution) {
  1515. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1516. ERR_FAIL_NULL(particles_collision);
  1517. ERR_FAIL_INDEX(p_resolution, RS::PARTICLES_COLLISION_HEIGHTFIELD_RESOLUTION_MAX);
  1518. if (particles_collision->heightfield_resolution == p_resolution) {
  1519. return;
  1520. }
  1521. particles_collision->heightfield_resolution = p_resolution;
  1522. if (particles_collision->heightfield_texture.is_valid()) {
  1523. RD::get_singleton()->free(particles_collision->heightfield_texture);
  1524. particles_collision->heightfield_texture = RID();
  1525. }
  1526. }
  1527. AABB ParticlesStorage::particles_collision_get_aabb(RID p_particles_collision) const {
  1528. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1529. ERR_FAIL_NULL_V(particles_collision, AABB());
  1530. switch (particles_collision->type) {
  1531. case RS::PARTICLES_COLLISION_TYPE_SPHERE_ATTRACT:
  1532. case RS::PARTICLES_COLLISION_TYPE_SPHERE_COLLIDE: {
  1533. AABB aabb;
  1534. aabb.position = -Vector3(1, 1, 1) * particles_collision->radius;
  1535. aabb.size = Vector3(2, 2, 2) * particles_collision->radius;
  1536. return aabb;
  1537. }
  1538. default: {
  1539. AABB aabb;
  1540. aabb.position = -particles_collision->extents;
  1541. aabb.size = particles_collision->extents * 2;
  1542. return aabb;
  1543. }
  1544. }
  1545. }
  1546. Vector3 ParticlesStorage::particles_collision_get_extents(RID p_particles_collision) const {
  1547. const ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1548. ERR_FAIL_NULL_V(particles_collision, Vector3());
  1549. return particles_collision->extents;
  1550. }
  1551. bool ParticlesStorage::particles_collision_is_heightfield(RID p_particles_collision) const {
  1552. const ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1553. ERR_FAIL_NULL_V(particles_collision, false);
  1554. return particles_collision->type == RS::PARTICLES_COLLISION_TYPE_HEIGHTFIELD_COLLIDE;
  1555. }
  1556. Dependency *ParticlesStorage::particles_collision_get_dependency(RID p_particles_collision) const {
  1557. ParticlesCollision *pc = particles_collision_owner.get_or_null(p_particles_collision);
  1558. ERR_FAIL_NULL_V(pc, nullptr);
  1559. return &pc->dependency;
  1560. }
  1561. /* Particles collision instance */
  1562. RID ParticlesStorage::particles_collision_instance_create(RID p_collision) {
  1563. ParticlesCollisionInstance pci;
  1564. pci.collision = p_collision;
  1565. return particles_collision_instance_owner.make_rid(pci);
  1566. }
  1567. void ParticlesStorage::particles_collision_instance_free(RID p_rid) {
  1568. particles_collision_instance_owner.free(p_rid);
  1569. }
  1570. void ParticlesStorage::particles_collision_instance_set_transform(RID p_collision_instance, const Transform3D &p_transform) {
  1571. ParticlesCollisionInstance *pci = particles_collision_instance_owner.get_or_null(p_collision_instance);
  1572. ERR_FAIL_NULL(pci);
  1573. pci->transform = p_transform;
  1574. }
  1575. void ParticlesStorage::particles_collision_instance_set_active(RID p_collision_instance, bool p_active) {
  1576. ParticlesCollisionInstance *pci = particles_collision_instance_owner.get_or_null(p_collision_instance);
  1577. ERR_FAIL_NULL(pci);
  1578. pci->active = p_active;
  1579. }